MCP Server Health Check

Was ist MCP Server Health Check?

MCP Server Health Check ist ein browserbasiertes Tool zum Testen, ob ein Model Context Protocol-(MCP)-Endpunkt korrekt auf den Handshake reagiert, den ein KI-Client bei der ersten Verbindung erwartet. Es sendet JSON-RPC-Anfragen für initialize, ping und tools/list und zeigt die Ergebnisse an, damit Sie sehen können, ob der Server gesund, teilweise funktionsfähig, authentifizierungsbedürftig oder nicht erreichbar ist.

Das Tool ist für Streamable-HTTP-MCP-Endpunkte konzipiert und kann ohne Installation von Software oder Konto verwendet werden. Es ist nützlich, wenn Sie prüfen möchten, ob ein Server den erwarteten Content-Type zurückgibt, die erforderlichen Protokollmethoden unterstützt und Tools korrekt ankündigt, bevor Sie ihn mit Clients wie Claude Desktop, Claude Code, Cursor oder einem benutzerdefinierten Agenten verbinden.

Hauptfunktionen

• Führt die MCP-Verbindungssequenz im Browser aus: initialize, notifications/initialized, ping und tools/list, um denselben Ablauf zu prüfen, den ein KI-Client verwendet.
• Prüft JSON-RPC- und MCP-spezifisches Verhalten statt nur HTTP-Statuscodes, sodass Probleme wie HTML-Antworten, fehlende Methoden oder fehlerhafte Protokollantworten erkannt werden können.
• Zeigt Latenz und Ergebnisdetails pro Schritt für jede Handshake-Phase an, damit sich leichter erkennen lässt, wo die Verbindung fehlschlägt oder langsamer wird.
• Zeigt Protokoll-Metadaten des Servers an, einschließlich ausgehandelter Protokollversion, Server-Info und Sitzungs-ID, falls vorhanden.
• Erkennt und klassifiziert gängige Ergebnisse wie Healthy, Partial, Authentication Required und Unreachable, um die Resultate schnell einordnen zu können.
• Behandelt Authentifizierungsaufforderungen, indem WWW-Authenticate und zugehörige Resource-Metadaten ausgewertet werden, wenn der Server OAuth-ähnlichen Schutz verwendet.
• Sendet automatisch Content-Type: application/json und Accept: application/json, text/event-stream und entspricht damit den üblichen MCP-Erwartungen.

So verwenden Sie MCP Server Health Check

Fügen Sie die URL Ihres MCP-Servers in das Formular ein, ergänzen Sie optional einen Authorization-Header, wenn der Endpunkt einen benötigt, und senden Sie die Prüfung ab. Das Tool führt die Handshake-Schritte aus und zeigt eine Ergebnistabelle mit dem Status jeder Anfrage an.

Sie können jede Zeile öffnen, um die genaue JSON-RPC-Anfrage und -Antwort einschließlich Headern und Protokolldetails zu prüfen. Wenn der Server eine Authentifizierungsaufforderung zurückgibt, können Sie die angezeigten Informationen zum Authorization-Server verwenden, um ein Token zu erhalten und es erneut zu versuchen.

Anwendungsfälle

• Prüfen eines neu bereitgestellten MCP-Endpunkts, bevor ein KI-Client darauf verweist, damit Handshake- oder Content-Type-Probleme früh erkannt werden.
• Fehlerbehebung bei einem Server, der HTTP 200 zurückgibt, aber in Claude Desktop, Cursor oder einem anderen MCP-Client nicht funktioniert.
• Überprüfen, ob ein geschützter MCP-Endpunkt den Authorization-Header akzeptiert oder einen anderen Token-Flow benötigt.
• Bestätigen, dass ein Server über tools/list nutzbare Tools ankündigt und nicht nur, dass die URL erreichbar ist.
• Prüfen von Protokollversion und Sitzungsverhalten, wenn sich ein MCP-Server ändert oder aktualisiert wird.

FAQ

• Testet es einen einfachen HTTP-Health-Endpunkt? Nein. Es testet den MCP-JSON-RPC-Handshake, den ein KI-Client verwendet, nicht nur, ob die URL 200 zurückgibt.
• Muss ich etwas installieren? Nein. Die Prüfung läuft im Browser.
• Kann es private Server testen? Ja, wenn Sie den benötigten Authorization-Header angeben.
• Was ist, wenn der Server 401 oder OAuth-bezogene Header zurückgibt? Das Tool wertet die Authentifizierungsaufforderung aus und zeigt verfügbare Informationen zum Authorization-Server an.
• Was bedeutet ein teilweises Ergebnis? Der Server scheint MCP zu sprechen, bietet aber möglicherweise keine Tools über tools/list an.

Alternativen

• Manuelles curl- oder HTTP-Client-Testing: Nützlich, wenn Sie volle Kontrolle über Anfragen wünschen, erfordert aber, dass Sie MCP-JSON-RPC-Aufrufe selbst zusammenstellen und die Antworten manuell interpretieren.
• Allgemeine API-Health-Check-Tools: Diese können Erreichbarkeit und HTTP-Status bestätigen, validieren aber meist nicht das MCP-Handshake-Verhalten oder die Tool-Erkennung.
• Ein MCP-Client wie Claude Desktop oder Cursor: Gut für die End-to-End-Nutzung, aber weniger darauf ausgerichtet, Handshake-Fehler und Probleme auf Protokollebene einzugrenzen.
• Dashboards für kontinuierliches Monitoring: Besser, wenn Sie statt einer einmaligen browserbasierten Prüfung eine fortlaufende Statusüberwachung benötigen.