Tool overview
Was ist MCP-Server-Validator?
MCP-Server-Validator ist ein Tool, mit dem Sie mcpServers-JSON-Clientkonfigurationen prüfen.
Warum MCP-Server-Validator verwenden?
Es verbessert die Lesbarkeit und beschleunigt Ihren Workflow, wenn Sie mcpServers-JSON-Clientkonfigurationen prüfen—vollständig im Browser ohne Server-Uploads.
Hauptfunktionen
Clientseitige Privatsphäre, sofortige Ergebnisse und Ein-Klick-Kopie für mCP-Server-Validator. mcpServers-JSON-Clientkonfigurationen prüfen
Anwendung
Befolgen Sie diese Schritte für genaue Ergebnisse mit dem Tool oben.
- Fügen Sie Ihre Cursor- oder Claude-Desktop-JSON-Konfiguration mit einem Top-Level-"mcpServers"-Objekt ein.
- Prüfen Sie den Lint-Bericht auf Fehler (blockierend) und Warnungen (nicht blockierend) mit JSON-Pointer-Pfaden.
- Beheben Sie Transporte: stdio braucht command (+ args); remote braucht eine gültige http/https-url.
- Stellen Sie sicher, dass env nur Strings enthält und args ein String-Array ist.
- Entfernen Sie duale command+url-Einträge und unbekannte Schlüssel mit Warnung, wenn möglich.
- Validieren Sie erneut, bis ok true ist — Warnungen allein scheitern nicht, sind aber Produktionsdebt.
- Fügen Sie das korrigierte JSON zurück in die Client-Config und laden Sie MCP-Server neu.
- Kopieren Sie den Bericht in eine PR- oder CI-Checkliste; halten Sie Secrets als Platzhalter.
MCP-Validator — vollständiger Leitfaden & Anwendungsfälle
Maßgebliche Anleitung: Fehler vs. Warnungen, Stdio vs. HTTP, Cursor- und Claude-Desktop-Fälle, Env-String-Regeln, Fixes und Secret-Hygiene.
MCP-Validator-Leitfaden — hier starten
Dieser Leitfaden erklärt die lokale Prüfung einer mcpServers-JSON-Konfiguration. Fügen Sie keine Secrets ein und beheben Sie Probleme vor Cursor oder Claude Desktop.
Was MCP Validator leistet
MCP Validator prüft mcpServers-Einträge, Transporte und JSON-Typen im Browser und erkennt Konfigurationen, die Clients nicht starten können.
Lokaler Bericht mit JSON-Pfaden und umsetzbaren Problemen
- Lokaler Bericht mit JSON-Pfaden und umsetzbaren Problemen
- Lokaler Bericht mit JSON-Pfaden und umsetzbaren Problemen: mcpServers, command, args, url, env
- Lokaler Bericht mit JSON-Pfaden und umsetzbaren Problemen: stdio, http, https
- Lokaler Bericht mit JSON-Pfaden und umsetzbaren Problemen: JSON, ok
Vor dem Einfügen oder Teilen einer MCP-Konfiguration verwenden
- Vor dem Einfügen oder Teilen einer MCP-Konfiguration verwenden
- Vor dem Einfügen oder Teilen einer MCP-Konfiguration verwenden: Cursor mcp.json
- Vor dem Einfügen oder Teilen einer MCP-Konfiguration verwenden: Claude Desktop
- Vor dem Einfügen oder Teilen einer MCP-Konfiguration verwenden: CI / PR
Für Schemas oder Prompts ein verwandtes Werkzeug verwenden
- Für Schemas oder Prompts ein verwandtes Werkzeug verwenden
- Für Schemas oder Prompts ein verwandtes Werkzeug verwenden: AI Agent Builder
- Für Schemas oder Prompts ein verwandtes Werkzeug verwenden: JSON Schema
Fehler und Warnungen — was das Einfügen blockiert
Fehler: Die Konfiguration blockiert die Validierung
Schweregrad-Leitfaden
| Schweregrad-Leitfaden | Auswirkung auf ok | Typische Ursachen |
|---|---|---|
| Fehler: Die Konfiguration blockiert die Validierung | Auswirkung auf ok: ok = false | Typische Ursachen |
| Warnung: Dieses Detail vor Produktion prüfen | Auswirkung auf ok: ok | Typische Ursachen |
Warnung: Dieses Detail vor Produktion prüfen
Schritt für Schritt: einfügen, prüfen, beheben, zurückkopieren
So hilft dieses Tool
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
- Pro Server genau einen Transport wählen.
- Für Remote-Server http:// oder https:// verwenden.
- env-Werte in Strings umwandeln.
- Erneut prüfen, bis ok true ist.
- Korrigiertes JSON in den Client einfügen.
Anwendungsfall: Cursor mcp.json vor dem Neuladen reparieren
Fehler: Die Konfiguration blockiert die Validierung Cursor mcp.json.
So hilft dieses Tool
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
- Pro Server genau einen Transport wählen.
Ergebnis: eine klare, geprüfte und einsatzbereite MCP-Konfiguration.
Anwendungsfall: Remote-MCP-URL in Claude Desktop
Fehler: Die Konfiguration blockiert die Validierung Claude Desktop.
So hilft dieses Tool
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
- Pro Server genau einen Transport wählen.
Ergebnis: eine klare, geprüfte und einsatzbereite MCP-Konfiguration.
Anwendungsfall: MCP-Vorlagen im PR-Review prüfen
Fehler: Die Konfiguration blockiert die Validierung CI / PR.
So hilft dieses Tool
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
- Pro Server genau einen Transport wählen.
Ergebnis: eine klare, geprüfte und einsatzbereite MCP-Konfiguration.
Anwendungsfall: Secret-Hygiene beim Debuggen
Fehler: Die Konfiguration blockiert die Validierung env.
So hilft dieses Tool
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
- Pro Server genau einen Transport wählen.
Ergebnis: eine klare, geprüfte und einsatzbereite MCP-Konfiguration.
Stdio- gegenüber HTTP/HTTPS-Transportregeln
Transportformen
Transportformen
| Transportformen | Pflichtfelder | Hinweise |
|---|---|---|
| stdio | command; args | Hinweise |
| HTTP / HTTPS | url (http:// or https://) | Hinweise |
Hinweise: env, headers, disabled.
Env-Werte müssen Zeichenfolgen sein
env: Pflichtfelder
- env: Pflichtfelder
- Pflichtfelder
- JSON
- mcpServers
Beheben: command oder url fehlt
Fehler: Die Konfiguration blockiert die Validierung: command or url.
Warum das passiert
Warum das passiert
Diagnose
Diagnose
Behebungen
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
Beheben: Nicht-String-env-Werte
Fehler: Die Konfiguration blockiert die Validierung: env.
Warum das passiert
Warum das passiert
Diagnose
Diagnose
Behebungen
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
Warnung: Dieses Detail vor Produktion prüfen
Beheben: falsches Root-Envelope
Fehler: Die Konfiguration blockiert die Validierung: mcpServers.
Warum das passiert
Warum das passiert
Diagnose
Diagnose
Behebungen
- JSON mit mcpServers einfügen.
- Zuerst Fehler beheben.
- command, args, url und env prüfen.
Best Practices für die MCP-Validierung
- Vor dem Einfügen in Cursor oder Claude Desktop prüfen.
- command oder url verwenden, nie beides.
- args als String-Array halten.
- env-Werte als Strings halten.
- Für Secrets Platzhalter verwenden.
- Absolute Pfade mit minimalen Rechten nutzen.
- Nach jeder Änderung erneut prüfen.
- Warnungen vor Produktion bereinigen.
Häufig gestellte Fragen
Antworten zu typischen Fehlern und Datenschutzfragen.
Verwandte Tools
Entdecken Sie weitere verwandte Dienstprogramme, die dieses Tool ergänzen.
Offizielle Dokumentation & Referenzen
Autoritative Spezifikationen und Plattformdokumentation für dieses Tool.