Wird geladen

Der Server-Inspector

Lektion 534 Min.
Wird geladen

Beim Erstellen von MCP-Servern benötigst du eine Möglichkeit, deine Funktionalität zu testen, ohne eine vollständige Anwendung anzubinden. 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 (überprüfe die README deines Projekts für den genauen Befehl). Starte dann den Inspector mit:

bash
mcp dev mcp_server.py

Dadurch wird ein Entwicklungsserver gestartet und du erhältst eine lokale URL (normalerweise auf Port 6277), um den Inspector in deinem Browser aufzurufen.

Terminal-Ausgabe: Proxy-Server lauscht auf Port 6277 und MCP Inspector läuft unter http://127.0.0.1:6274.

Die Inspector-Oberfläche verwenden

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 schaltest du den Schalter auf der Karte deines Servers ein, anstatt auf „Connect“ zu klicken, der Tab Tools listet deine Tools ohne einen „List Tools“-Button auf, und „Run Tool“ heißt „Execute Tool“.

Der MCP-Inspector vor dem Verbinden, mit Standard-Ein-/Ausgabe-Transport, einem „Connect“-Button und Status „Disconnected“.

Nachdem du auf „Connect“ geklickt hast, um deinen MCP-Server zu starten, siehst du eine Navigationsleiste mit Abschnitten für:

  • Resources
  • Prompts
  • Tools
  • Weitere Server-Fähigkeiten

Deine Tools testen

Der Tools-Bereich ist der Ort, an dem du die meiste Zeit mit dem Debugging verbringen wirst. Klicke auf „List Tools“, um alle Tools anzuzeigen, die dein Server bereitstellt.

MCP Inspector Tools-Tab nach dem Klick auf „List Tools“, mit einer Auflistung von read_doc_contents und edit_document samt Beschreibung.

Wenn du ein Tool auswählst, zeigt das rechte Panel dessen Details und bietet Eingabefelder zum Testen. Um zum Beispiel das Tool read_doc_contents zu testen:

  1. Wähle das Tool aus der Liste
  2. Gib eine Dokument-ID ein (z. B. „deposition.md“)
  3. Klicke auf „Run Tool“
  4. Überprüfe die Ergebnisse auf Erfolg und erwartete Ausgabe

MCP Inspector Tools-Tab mit den Tools read_doc_contents und edit_document, einem doc_id-Feld und dem Run Tool-Button.

Interaktionen zwischen Tools testen

Du kannst mehrere Tools nacheinander testen, um zu überprüfen, ob sie korrekt zusammenarbeiten. Zum Beispiel, nachdem du das Tool edit_document verwendet hast, um Inhalte zu ändern:

MCP Inspector edit_document-Formular mit doc_id deposition.md, old_str „This“ und new_str „A report“, sowie Tool Result: Success.

Führe das Tool read_doc_contents erneut mit derselben Dokument-ID aus, um zu bestätigen, dass deine Änderungen übernommen wurden:

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

Entwicklungs-Workflow

Der Inspector schafft eine effiziente Entwicklungsschleife:

  • Nimm Änderungen an deinem MCP-Server-Code vor
  • Teste einzelne Tools mit verschiedenen Eingaben
  • Überprüfe, ob die Interaktionen zwischen Tools wie erwartet funktionieren
  • Debugge Probleme, ohne eine vollständige Anwendung einrichten zu müssen

Diese browserbasierte Testumgebung ist für die Entwicklung von MCP-Servern unerlässlich. Sie spart Zeit, indem sie es dir ermöglicht, Probleme frühzeitig zu erkennen und die Funktionalität zu überprüfen, bevor du sie in Claude oder andere Anwendungen integrierst.