Wird geladen
Wird geladen

Beim Erstellen von MCP-Servern brauchst du eine Möglichkeit, deine Funktionalität zu testen, ohne dich mit einer vollständigen Anwendung zu verbinden. Das Python MCP SDK enthält einen integrierten, browserbasierten Inspector, mit dem du deinen Server in Echtzeit debuggen und testen kannst.

Den Inspector starten

Stelle zunächst sicher, dass deine Python-Umgebung aktiviert ist (den genauen Befehl findest du im README deines Projekts). Starte den Inspector dann mit:

bash
mcp dev mcp_server.py

Dadurch wird ein Entwicklungsserver auf Port 6277 gestartet, und du erhältst eine lokale URL, die du in deinem Browser öffnen kannst. Die Inspector-Oberfläche wird geladen und zeigt das MCP-Inspector-Dashboard an.

MCP-Inspector-Dashboard vor dem Verbinden: Transporttyp STDIO, Befehl uv, eine „Connect“-Schaltfläche und Status „Disconnected“.

Wichtiger Hinweis zur Oberfläche

Die Bilder hier und das Video zeigen Version 1 des Inspectors, aber mcp dev startet jetzt Version 2, die Node.js 22.19 oder höher benötigt. In Version 2 aktivierst du den Schalter auf der Karte deines Servers, anstatt auf „Connect“ zu klicken, der Tab Tools listet deine Tools ohne eine „List Tools“-Schaltfläche auf, und „Run Tool“ heißt jetzt „Execute Tool“.

Verbinden und Testen von Tools

Klicke links auf die Schaltfläche „Connect“, um deinen MCP-Server zu starten. Sobald die Verbindung besteht, siehst du eine Navigationsleiste mit Bereichen für Resources, Prompts, Tools und andere Funktionen.

MCP-Inspector nach dem Verbinden, zeigt den Status Connected und die Tabs Resources, Prompts, Tools, Ping, Sampling und Roots.

So testest du deine Tools:

  • Navigiere zum Bereich Tools
  • Klicke auf „List Tools“, um alle verfügbaren Tools anzuzeigen
  • Wähle ein Tool aus, um dessen Testoberfläche zu öffnen
  • Fülle die erforderlichen Parameter aus
  • Klicke auf „Run Tool“, um es auszuführen und die Ergebnisse zu sehen

MCP-Inspector-Tab Tools mit den Tools read_doc_contents und edit_document, jeweils mit einer kurzen Beschreibung.

Testen von Dokumentoperationen

Um beispielsweise ein Tool zum Lesen von Dokumenten zu testen, würdest du eine Dokument-ID eingeben (z. B. „deposition.md“) und das Tool ausführen. Der Inspector zeigt das Ergebnis an, einschließlich aller zurückgegebenen Inhalte oder Erfolgsmeldungen.

MCP-Inspector-Ergebnis für read_doc_contents bei „deposition.md“: „Success“ und Text, der mit „A report deposition covers“ beginnt.

Du kannst Operationen verketten, um die Funktionalität zu überprüfen. Nachdem du beispielsweise ein Dokument durch Ersetzen von Text bearbeitet hast, kannst du sofort das Lese-Tool erneut ausführen, um zu bestätigen, dass die Änderungen korrekt übernommen wurden.

Entwicklungs-Workflow

Der Inspector schafft eine effiziente Entwicklungsschleife:

  • Änderungen am Code deines MCP-Servers vornehmen
  • Einzelne Tools über den Inspector testen
  • Ergebnisse überprüfen, ohne eine vollständige Anwendung einrichten zu müssen
  • Probleme isoliert debuggen

Dieses Tool wird unverzichtbar, je komplexer die MCP-Server werden, die du erstellst. Es macht es überflüssig, deinen Server mit Claude oder einer anderen Anwendung zu verbinden, nur um grundlegende Funktionalität zu testen, was die Entwicklung viel schneller und fokussierter macht.