MCP Inspector – Debug Model Context Protocol Servers Cheatsheet

MCP Inspector ist das offizielle visuelle Test- und Debugging-Tool für Model Context Protocol Server. Wenn Sie einen MCP-Server bauen, müssen Sie sehen, was er tatsächlich exponiert und wie er antwortet – Inspector verbindet sich mit Ihrem Server, listet seine Tools, Ressourcen und Prompts auf, lässt Sie jeden mit beliebigen Argumenten aufrufen und zeigt die rohen JSON-RPC-Nachrichten in beiden Richtungen. Es ist der schnellste Weg, einen Server zu überprüfen, bevor Sie ihn in Claude, Cursor oder einen anderen Client verdrahten.

Es ausführen

Methode	Befehl
npx (keine Installation)	`npx @modelcontextprotocol/inspector`
Mit Ihrem Server	`npx @modelcontextprotocol/inspector node build/index.js`
Python-Server	`npx @modelcontextprotocol/inspector uv run server.py`
Remote/SSE-Server	Starten Sie, dann geben Sie die URL in der UI ein
UI	Öffnet sich im Browser (Standard `http://localhost:6274`)

Verbindungstypen

Transport	Verwenden
STDIO	Lokaler Server als Subprocess ausgeführt (am häufigsten)
SSE	Remote-Server über Server-Sent Events
Streamable HTTP	Moderner Remote-Transport

# Inspizieren Sie einen lokalen STDIO-Server, passieren Sie Args und Env
npx @modelcontextprotocol/inspector \
  -e API_KEY=abc123 \
  node build/index.js --verbose

Die Schnittstelle

Tab	Zeigt
Tools	Jedes Tool, sein JSON-Schema und ein Formular zum Aufrufen
Resources	Exponierte Ressourcen und ihre Inhalte
Prompts	Prompt-Templates und ihre Argumente
Notifications	Server-initiierte Nachrichten/Logs
History	Jedes Request/Response-Paar

Tools testen

Schritt	Aktion
1	Öffnen Sie die Tools Tab; bestätigen Sie, dass Ihr Tool aufgelistet ist
2	Überprüfen Sie, das Input-Schema rendert korrekt (Typen, erforderliche Felder)
3	Füllen Sie das erzeugte Formular aus und klicken Sie zum Aufrufen
4	Inspizieren Sie den zurückgegebenen Inhalt und jedes `isError` Flag
5	Lesen Sie die rohen JSON-RPC in History zum Debugging von Shape-Problemen

Diese Schleife fängt die häufigsten MCP-Bugs: ein malformed Schema, ein Tool, das die falsche Content-Shape zurückgibt, oder ein unbehandelter Error.

Was Sie vor dem Versand überprüfen sollten

Überprüfung	Warum
Tool-Namen sind eindeutig/beschreibend	Clients exponieren sie dem Modell
Beschreibungen erklären wann das Tool zu verwenden ist	Treibt die korrekte Modell-Auswahl
Input-Schema ist präzise	Verhindert malformed Aufrufe
Fehler geben `isError` mit Nachricht zurück	Modell kann sich erholen
Große Ausgaben sind paginiert/gekürzt	Vermeidung der Context-Window-Sprengen
Ressourcen haben stabile URIs	Clients cachen/referenzieren sie

Debugging-Tipps

Symptom	Schauen Sie auf
Server konnte sich nicht verbinden	Befehl/Args; Stderr im Start-Terminal
Tool vermisst	Registrierungs-Code; Starten Sie den Server neu
Schema rendert merkwürdig	JSON Schema Typen in der Tool-Definition
Client verhält sich unterschiedlich	Vergleichen Sie rohen JSON-RPC in History
Env-abhängiger Bug	Starten Sie Inspector neu mit `-e KEY=value`

Häufige Workflows

# Entwickeln-und-Test-Schleife für einen TypeScript MCP Server
npm run build && npx @modelcontextprotocol/inspector node build/index.js

# Testen Sie einen Python-Server mit uv
npx @modelcontextprotocol/inspector uv run my_server.py

# Überprüfen Sie einen Remote SSE-Server vor dem Hinzufügen zu einem Client
npx @modelcontextprotocol/inspector   # Wählen Sie SSE, fügen Sie die URL ein

MCP Inspector vs Alternativen

Ansatz	Trade-off
MCP Inspector	Purpose-built, visuell, zeigt rohes Protokoll
Verdrahtung in echten Client	Realistisch aber langsame Feedback-Schleife
Hand-geschriebenes JSON-RPC	Volle Kontrolle, mühsam
Unit Tests	Schnell und wiederholbar; paaren Sie mit Inspector für Erkundung

Verwenden Sie Inspector während des Aufbaus, dann fügen Sie automatisierte Tests hinzu; siehe MCP Servers für Server-Implementierungs-Muster.