MCPJam Inspector (MCP server) — Anwendungsfälle, Installieren & Live-Demo

Name: MCPJam Inspector MCP Server
Author: MCPJam

Warum nutzen

Hauptfunktionen

Beliebigen MCP-Transport verbinden: stdio / SSE / streamable HTTP
Beliebiges Tool manuell mit formulargesteuerten Eingaben und Live-JSON-Schema-Validierung aufrufen
Eingebetteter Chat, der die Tools des Servers nutzt — sehen wie ein LLM sie tatsächlich verwendet
Eval-Modus: einen Prompt gegen mehrere Modelle laufen lassen, Tool-Use-Traces vergleichen
Funktioniert auch für ChatGPT-Apps, nicht nur MCP-Server

Live-Demo

In der Praxis

mcpjam-inspector.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpjam-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mcpjam-inspector",
      "command": "npx",
      "args": [
        "-y",
        "@mcpjam/inspector"
      ]
    }
  ]
}

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcpjam-inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@mcpjam/inspector"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcpjam-inspector -- npx -y @mcpjam/inspector

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: MCPJam Inspector

Debuggen warum ein MCP-Tool falsch aufgerufen wird

👤 MCP-Server-Entwickler ⏱ ~20 min intermediate

Wann einsetzen: Du hast ein Tool gebaut, und Claude ruft es immer wieder mit den falschen Argumenten auf.

Voraussetzungen

Inspector läuft — npx -y @mcpjam/inspector (öffnet Browser auf localhost:6274)
Dein MCP-Server — Bereit zum Starten via stdio-Befehl oder SSE-URL

Ablauf

Server verbinden

In the inspector UI, add a stdio server: command=node, args=[./dist/server.js].✓ Kopiert

→ Tool-Liste erscheint mit Beschreibungen + Schemas
LLM-Ansicht lesen

Look at the rendered description in the tool detail panel — that's exactly what the model sees.✓ Kopiert

→ Mehrdeutigkeit erkennen ("id" sollte "task_id" sein, oder Beispiel fehlt)
Fehlverwendung reproduzieren

Open Chat tab. Send the user prompt that caused the failure. Watch the tool_use payload.✓ Kopiert

→ Derselbe fehlerhafte Aufruf wie in Produktion
Beschreibung korrigieren, erneut testen

Update the tool's description and example in your server code, restart, retry the same prompt.✓ Kopiert

→ Diesmal korrekter Aufruf

Ergebnis: Konkrete Korrektur, gestützt auf evidenzbasierten Vorher-/Nachher-Vergleich.

Fallstricke

Veraltetes Schema nach Server-Neustart gecacht — Im Server-Panel auf „Reconnect" klicken; der Inspector holt list_tools neu ab

Evaluieren wie verschiedene Modelle die Tools deines MCP-Servers nutzen

👤 Server-Entwickler, die auf mehrere Clients abzielen ⏱ ~45 min advanced

Wann einsetzen: Du willst wissen ob dein Server mit Sonnet genauso gut funktioniert wie mit Haiku/GPT-5.

Ablauf

Eval-Set erstellen

Author 10 representative user prompts in the Eval tab. Mix easy and adversarial.✓ Kopiert

→ Eval gespeichert mit Prompts + erwarteten Tool-Sequenzen
Über Modelle hinweg ausführen

Run the eval against Sonnet 4.6, Haiku 4.5, and GPT-5. Compare tool-use traces.✓ Kopiert

→ Pro-Modell-Trace; Bestehen/Fehlschlagen pro Prompt
Schwächstes Schema verbessern

On the failing prompts, what description change would fix the cheaper model without breaking Sonnet?✓ Kopiert

→ Konkretes Umschreiben der Beschreibung

Ergebnis: Ein Server, der über die gesamte Modellpalette funktioniert, nicht nur dem getesteten.

Fallstricke

Eval testet nur den Happy Path — Adversarielle Prompts hinzufügen: fehlende Argumente, widersprüchliche Eingaben, unvollständige Infos

Unbekannten Drittanbieter-MCP-Server sicher erkunden

👤 Alle, die einen Community-MCP evaluieren ⏱ ~15 min intermediate

Wann einsetzen: Du erwägst, jemandes MCP zu deiner Konfiguration hinzuzufügen, und willst zuerst sehen, welche Tools er exponiert.

Ablauf

Isoliert starten

Add the server in inspector — don't put it in your real client config yet.✓ Kopiert

→ Tools aufgelistet mit vollständigen Beschreibungen
Oberfläche prüfen

Scan tool list. Anything that writes/deletes/runs code? Anything that calls external URLs?✓ Kopiert

→ Risikokategorisierte Tool-Liste
Riskante Tools manuell testen

Hand-call each write tool with a no-op payload to see what it actually does.✓ Kopiert

→ Verhalten bestätigt bevor es einem autonomen Agenten ausgesetzt wird

Ergebnis: Informierte Install/Skip-Entscheidung statt blindem Vertrauen.

Fallstricke

Tool führt Shell-Befehle aus — auch manueller Aufruf kann das System verändern — In einem Container oder Scratch-Verzeichnis ausführen; niemals unbekannte MCPs auf dem täglichen Arbeitsrechner prüfen

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcpjam-inspector + github

Eigenen MCP-Server in CI profilieren

On every PR, run inspector eval against the main + PR head; comment diff in the PR via github MCP.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
list_tools	server connection	Läuft automatisch beim Verbinden — selten manuell aufgerufen	0
call_tool	tool_name, args	Beliebiges Tool manuell mit Formulareingaben aufrufen	depends on tool
chat	model, messages	Ein LLM durch deine Tools treiben um emergentes Verhalten zu beobachten	depends on model API
run_eval	eval_set, models[]	Cross-Modell-Regressionscheck vor dem Ship	API calls × models × prompts

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Eval-Modus trifft LLM-Provider-Quotas — eigene Keys mitbringen
Tokens pro Aufruf: 0 für den Inspector selbst; vollständige Agent-Kosten für Chat/Eval
Kosten in €: Kostenlos (Open Source) — du zahlst nur Modell-API-Kosten
Tipp: Haiku für Eval-Iterationen verwenden; auf Sonnet nur für den finalen Cross-Modell-Check wechseln

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Standardmäßig nur lokales Netzwerk

Credential-Speicherung: API-Keys für Eval-Modelle standardmäßig im Browser-localStorage — nach Verwendung auf gemeinsam genutzten Rechnern löschen

Datenabfluss: Nur zu konfigurierten Modell-Providern (Anthropic, OpenAI, etc.) und verbundenen MCP-Servern

Niemals gewähren: Öffentlicher Internetzugang — Inspector auf localhost halten

Das Inspizieren eines bösartigen MCP-Servers führt dennoch dessen Code auf deinem Rechner aus — Unbekannte in einer Sandbox isolieren

Fehlerbehebung

Häufige Fehler und Lösungen

Server verbindet sich nicht (stdio)

Prüfen ob der Befehlspfad absolut und das Arbeitsverzeichnis gesetzt ist; stderr im Inspector-Logs-Panel prüfen

Prüfen: Run the server command manually in a terminal first

SSE-Server hängt beim Verbinden

CORS- oder Auth-Header-Problem — prüfen ob SSE-Endpunkt Cross-Origin-Anfragen von localhost:6274 akzeptiert

Prüfen: curl -N <sse_url> with -H 'Accept: text/event-stream'

Eval läuft aber alle Modelle schlagen fehl

API-Key-Gültigkeit in den Einstellungen prüfen; prüfen ob Modellnamen mit aktueller Benennung des Providers übereinstimmen

Inspector-Port bereits belegt

PORT=6275 npx @mcpjam/inspector

Prüfen: lsof -i :6274

Alternativen

MCPJam Inspector vs. andere

Alternative	Wann stattdessen	Kompromiss
modelcontextprotocol/inspector (official)	Kanonischer Referenz-Inspector mit konservativstem Feature-Set gewünscht	Fehlt Chat/Eval-Modi; niedrigeres Level
wong2/mcp-cli	Terminal gegenüber UI bevorzugt	Kein visueller Eval-Vergleich oder Schema-Rendering

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen