LLM-Server debuggen ohne Kopfschmerzen mit dem MCP Inspector

Sie kennen das Gefühl: Sie versuchen, einen KI-Agenten mit Ihrer lokalen API zum Laufen zu bringen, und er friert entweder ein oder spuckt einen kryptischen Fehler aus. Sie fragen sich: Ist der Prompt kaputt, ist der Server abgestürzt, oder kommen die Daten im falschen Format? Ein bekanntes Szenario. Die Entwickler bei Anthropic scheinen dasselbe durchgemacht zu haben, weshalb sie MCP Inspector veröffentlicht haben.

Dies ist ein visueller Debugger für das Model Context Protocol (MCP). Kurz gesagt, MCP ist ein neuer Standard, der Sprachmodellen hilft, mit externen Tools, Datenbanken und Dateisystemen zu kommunizieren. Und Inspector ist im Grunde ein Postman, jedoch speziell zugeschnitten auf die Arbeit mit LLM-Servern.

Was steckt dahinter und wie es funktioniert

Das Tool besteht aus zwei Teilen. Der erste ist ein React-Client, den Sie im Browser sehen. Der zweite ist ein Proxy-Server, der auf Node.js läuft. Dieser Proxy ist der interessanteste Teil: Er kann Standard-Ein-/Ausgabe-Streams (stdio) oder HTTP-Streams in eine browserfreundliche Oberfläche umwandeln.Viele MCP-Server arbeiten über reguläre Konsolen-Ein-/Ausgabe. Ein Browser kann nicht direkt mit einem solchen Prozess kommunizieren, also fungiert der Proxy als Brücke: Er startet Ihren Server, fängt seine Nachrichten ab und streamt sie zur Web-Oberfläche.

Schnell loslegen

Wenn Sie Node.js Version 22.7.5 oder höher haben, geben Sie einfach in Ihr Terminal ein:

npx @modelcontextprotocol/inspector

Der Befehl startet eine Web-Oberfläche auf http://localhost:6274. Die Port-Auswahl ist übrigens clever: 6274 entspricht den MCPI-Tasten (MCP Inspector) auf einem alten Tastaturhandy.

Wenn Sie gerade Ihren eigenen Server entwickeln, können Sie den Inspector direkt darauf zeigen:

npx @modelcontextprotocol/inspector node build/index.js

Der Inspector nimmt den Build auf, übergibt die notwendigen Argumente und öffnet den Browser mit allen Ihren Tools und Ressourcen sichtbar.

Was dieser Debugger kann

Der Hauptvorteil des Inspectors ist seine Interaktivität. Sie müssen keine Skripte schreiben, um jede Funktion zu testen.

Erstens gibt es das Testen von Tools. Sie sehen eine Liste aller Funktionen, die der Server dem Modell zur Verfügung stellt. Sie können die Argumente direkt im Formular ausfüllen (kein manuelles JSON in der Konsole) und auf „Call Tool" klicken. Die Antwort kommt sofort zurück, und Sie können sofort sehen, ob die Datenstruktur sich „verschoben" oder verfälscht wurde.

Zweitens gibt es das Durchsuchen von Ressourcen. Wenn Ihr Server Zugriff auf Dateien oder Logs bietet, können Sie diese in einer Baumstruktur im Inspector erkunden. Das ist ein Segen, wenn Sie genau verstehen müssen, welchen Kontext das Modell erhält.

Drittens gibt es die Prompt-Handhabung. Sie können die im Server eingebetteten Prompt-Vorlagen testen und sehen, wie sie in Echtzeit mit Daten gefüllt werden.

Sicherheit und Feinheiten

Die Entwickler haben die große Warnung im README nicht ohne Grund hinzugefügt. Im Kern bedeutet es, dass der Proxy-Server das Recht hat, Prozesse auf Ihrem Rechner zu starten. Wenn Sie den Port einfach ins Internet öffnen, kann jeder beliebigen Code ausführen.

Standardmäßig generiert der Inspector ein zufälliges Session-Token. Es sieht so aus: http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=ваш_длинный_хеш

Ich würde nicht empfehlen, diese Prüfung mit dem DANGEROUSLY_OMIT_AUTH Flag zu deaktivieren, selbst wenn Sie zu faul sind, den Link zu kopieren. Es gab Fälle (CVE-2025-49596), bei denen solche offenen Ports zu RCE führen konnten, nur durch das Besuchen einer bösartigen Website in einem anderen Browser-Tab.

Wann man es verwendet

Für mich war die größte Entdeckung der CLI-Modus. Er eignet sich perfekt für die Kombination mit Cursor oder anderen KI-Coding-Assistenten. Sie können einen Befehl ausführen:

npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list

Und erhalten sauberes JSON mit einer Liste von Tools. Das beschleunigt den Zyklus „Code geschrieben – getestet – korrigiert" enorm.

Der Inspector wird Ihnen definitiv helfen, wenn Sie:

1. Einen benutzerdefinierten MCP-Server für Ihr Unternehmen entwickeln.
2. Versuchen, Claude Desktop mit einer lokalen Datenbank zu verbinden.
3. Komplexe Tool-Aufrufketten debuggen, bei denen die Reihenfolge der Argumente wichtig ist.

Das Tool hat sich für ein so junges Protokoll als überraschend solide erwiesen. Ja, die Dokumentation ist noch etwas dünn, und die Oberfläche wirkt spartanisch, aber es excels bei seiner Aufgabe – „Ihnen zu zeigen, was unter der Haube eines LLM-Servers passiert".

Wenn Sie planen, KI-Agenten in Ihre Workflows zu integrieren, setzen Sie ein Lesezeichen für dieses Repo. Es wird Ihnen viele Stunden beim Debuggen von vergessenen Feldern in JSON-Schemata oder falschen Dateipfaden ersparen.