MCP Inspector Anleitung

Der MCP Inspector ist ein interaktives Entwickler-Tool zum Testen und Debuggen von MCP-Servern. Er bietet eine webbasierte Oberfläche und eine CLI für umfassende Test-Workflows.

Architektur

Der Inspector besteht aus zwei Komponenten:

Inspector Client — React-Web-Oberfläche (Standard-Port 6274) für interaktive Tests
Inspector Proxy — Node.js-Server (Standard-Port 6277), der die Web-Oberfläche mit Ihrem MCP-Server verbindet

Der Proxy fungiert sowohl als MCP-Client (verbindet sich mit Ihrem Server) als auch als HTTP-Server (bedient die Web-Oberfläche) und ermöglicht so die browserbasierte Interaktion mit MCP-Servern unter Verwendung verschiedener Transportprotokolle.

npm run build
npx @modelcontextprotocol/inspector node dist/index.js

Öffnet eine Web-Oberfläche unter http://localhost:6274 mit einem vorausgefüllten Authentifizierungs-Token.

# Verfügbare Tools auflisten
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

# Spezifisches Tool aufrufen
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call \
  --tool-name onlyoffice_list_templates

# Tool mit Argumenten aufrufen
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call \
  --tool-name onlyoffice_validate_data \
  --tool-arg template=stellenbeschreibung \
  --tool-arg 'data={"Positionstitel":"Test"}'

Transporttypen

Transport	Anwendungsfall	Flag
STDIO	Lokale Prozesse (Standard)	`--transport stdio`
SSE	Remote-Server über Server-Sent Events	`--transport sse`
Streamable HTTP	Remote-Server über HTTP POST	`--transport http`

Für Remote-Tests:

# Streamable HTTP-Transport
npx @modelcontextprotocol/inspector --cli https://onlyoffice.localhost --transport http

Test-Workflow

Mit dem Server verbinden

Im UI-Modus sind der Befehl (node) und die Argumente (dist/index.js) vorausgefüllt. Klicken Sie auf Connect. Prüfen Sie, dass der Status „Connected“ mit der Server-Version anzeigt.
Verfügbare Tools auflisten

Klicken Sie auf den Reiter Tools, dann auf List Tools. Prüfen Sie, ob 26 Tools aufgelistet werden (21, wenn CREDENTIAL_MASTER_PASSWORD nicht gesetzt ist).
onlyoffice_list_templates testen

Wählen Sie onlyoffice_list_templates, lassen Sie die Parameter leer, klicken Sie auf Run Tool. Prüfen Sie, ob die Antwort 5 generische Vorlagen mit Metadaten enthält.
onlyoffice_validate_data testen

Wählen Sie onlyoffice_validate_data, geben Sie ein:
- template: stellenbeschreibung
- data: {"Positionstitel":"Software Engineer","Fachbereich":"IT"}
Führen Sie das Tool aus. Die Antwort sollte valid: false mit den fehlenden Pflichtfeldern anzeigen.
onlyoffice_generate_document testen

Erfordert den laufenden OnlyOffice Docker-Container:
Terminal window
```
docker compose -f docker/docker-compose.yml up -d
```
Wählen Sie onlyoffice_generate_document, geben Sie ein:
- template: stellenbeschreibung
- format: docx
- data: Vollständiges gültiges JSON mit allen Pflichtfeldern
Führen Sie das Tool aus. Prüfen Sie, ob die Antwort das generierte Dokument-Artefakt enthält.

Konfiguration

Umgebungsvariablen

Übergeben Sie Umgebungsvariablen an Ihren MCP-Server mit -e:

npx @modelcontextprotocol/inspector -e ONLYOFFICE_JWT_SECRET=secret -e ADMIN_PASSWORD=test node dist/index.js

Benutzerdefinierte Ports

CLIENT_PORT=8080 SERVER_PORT=9000 npx @modelcontextprotocol/inspector node dist/index.js

Einstellungen

Einstellung	Standard	Beschreibung
`MCP_SERVER_REQUEST_TIMEOUT`	300000	Request-Timeout (ms)
`MCP_REQUEST_TIMEOUT_RESET_ON_PROGRESS`	true	Timeout bei Fortschritt zurücksetzen
`MCP_REQUEST_MAX_TOTAL_TIMEOUT`	60000	Maximales Gesamt-Timeout (ms)
`MCP_AUTO_OPEN_ENABLED`	true	Browser automatisch öffnen

Teststrategie

Testtyp	Ansatz
Happy Path	Gültige Eingaben, erwartete Ausgaben
Randfälle	Leere Arrays, Sonderzeichen, Grenzwerte
Fehlerbehandlung	Ungültige Vorlagen-IDs, fehlende Pflichtfelder
Leistung	Große Payloads, Stapelgenerierung

CLI-Randfall-Tests

# Test mit ungültiger Vorlage
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call \
  --tool-name onlyoffice_validate_data \
  --tool-arg template=nonexistent \
  --tool-arg 'data={}'

# Test mit fehlenden Pflichtfeldern
npx @modelcontextprotocol/inspector --cli node dist/index.js \
  --method tools/call \
  --tool-name onlyoffice_validate_data \
  --tool-arg template=stellenbeschreibung \
  --tool-arg 'data={"Positionstitel":"Only one field"}'