MCPJam Inspector (MCP server) — Cas d'usage, Installer & Démo en direct

Name: MCPJam Inspector MCP Server
Author: MCPJam

Pourquoi l'utiliser

Fonctionnalités clés

Connexion à tout transport MCP : stdio / SSE / streamable HTTP
Appel manuel de tout outil avec saisie guidée par formulaire et validation JSON Schema en direct
Chat intégré utilisant les outils du serveur — voir comment un LLM les utilise réellement
Mode évaluation : lancer un prompt sur plusieurs modèles, comparer les traces d'appels d'outils
Fonctionne aussi pour les applications ChatGPT, pas seulement les serveurs MCP

Démo en direct

Aperçu en pratique

mcpjam-inspector.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      ]
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

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

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

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

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

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCPJam Inspector

Déboguer pourquoi votre outil MCP est appelé avec les mauvais arguments

👤 Auteurs de serveurs MCP ⏱ ~20 min intermediate

Quand l'utiliser : Vous avez livré un outil, et Claude continue de l'appeler avec de mauvais arguments.

Prérequis

Inspector en cours d'exécution — npx -y @mcpjam/inspector (ouvre le navigateur sur localhost:6274)
Votre serveur MCP — Prêt à lancer via commande stdio ou URL SSE

Déroulement

Connecter le serveur

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

→ La liste des outils apparaît avec descriptions + schémas
Lire la vue du LLM

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

→ Repérer l'ambiguïté ("id" devrait être "task_id", ou exemple manquant)
Reproduire le mauvais usage

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

→ Le même mauvais appel que vous avez vu en production
Corriger la description, retester

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

→ Appel correct cette fois

Résultat : Correction concrète étayée par un avant/après factuel.

Pièges

Schéma périmé mis en cache après redémarrage du serveur — Cliquer sur «Reconnect» dans le panneau serveur ; l'inspector re-interroge list_tools

Évaluer comment différents modèles utilisent les outils de votre serveur MCP

👤 Auteurs de serveurs ciblant plusieurs clients ⏱ ~45 min advanced

Quand l'utiliser : Vous voulez savoir si votre serveur fonctionne aussi bien avec Sonnet qu'avec Haiku/GPT-5.

Déroulement

Construire un jeu d'évaluation

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

→ Évaluation sauvegardée avec prompts + séquences d'outils attendues
Exécuter sur plusieurs modèles

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

→ Trace par modèle ; réussite/échec par prompt
Renforcer le schéma le plus faible

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

→ Réécriture concrète de la description

Résultat : Un serveur qui fonctionne sur toute la gamme de modèles, pas seulement celui que vous avez testé.

Pièges

L'évaluation ne teste que le chemin heureux — Ajouter des prompts adversariaux : arguments manquants, entrées contradictoires, informations partielles

Explorer en toute sécurité un serveur MCP tiers inconnu

👤 Toute personne évaluant un MCP communautaire ⏱ ~15 min intermediate

Quand l'utiliser : Vous envisagez d'ajouter le MCP de quelqu'un à votre config et voulez d'abord voir les outils exposés.

Déroulement

Lancer en isolation

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

→ Outils listés avec descriptions complètes
Auditer la surface

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

→ Liste d'outils catégorisée par risque
Tester manuellement les outils risqués

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

→ Vous confirmez le comportement avant d'exposer à un agent autonome

Résultat : Décision d'installation/refus éclairée plutôt que confiance aveugle.

Pièges

L'outil lance un shell — même un appel manuel peut muter votre système — Exécuter dans un container ou un répertoire temporaire ; ne jamais inspecter de MCP non fiable sur votre machine principale

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcpjam-inspector + github

Profiler votre propre serveur MCP en CI

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

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
list_tools	connexion serveur	S'exécute automatiquement à la connexion — rarement appelé manuellement	0
call_tool	tool_name, args	Appeler manuellement tout outil avec saisie par formulaire	dépend de l'outil
chat	model, messages	Piloter un LLM à travers vos outils pour observer le comportement émergent	dépend de l'API du modèle
run_eval	eval_set, models[]	Vérification de régression multi-modèles avant livraison	appels API × modèles × prompts

Coût et limites

Coût d'exécution

Quota d'API: Le mode évaluation consomme le quota des fournisseurs LLM — apportez vos propres clés
Tokens par appel: 0 pour l'inspector lui-même ; coût agent complet pour chat/eval
Monétaire: Gratuit (open source) — vous payez uniquement les coûts API des modèles
Astuce: Utiliser Haiku pour les itérations d'évaluation ; passer à Sonnet seulement pour la vérification multi-modèles finale

Sécurité

Permissions, secrets, portée

Portées minimales : Réseau local uniquement par défaut

Stockage des identifiants : Les clés API pour les modèles d'évaluation sont stockées dans localStorage du navigateur par défaut — effacer après usage sur des machines partagées

Sortie de données : Uniquement vers les fournisseurs de modèles que vous configurez (Anthropic, OpenAI, etc.) et les serveurs MCP que vous connectez

Ne jamais accorder : Accès internet public — garder l'inspector sur localhost

Inspecter un serveur MCP malveillant exécute quand même son code sur votre machine — isoler les inconnus dans un sandbox

Dépannage

Erreurs courantes et correctifs

Le serveur échoue à se connecter (stdio)

Vérifier que le chemin de commande est absolu et que le répertoire de travail est défini ; vérifier stderr dans le panneau logs de l'inspector

Vérifier : Exécuter la commande du serveur manuellement dans un terminal d'abord

Le serveur SSE reste bloqué à la connexion

Problème de CORS ou d'en-tête d'auth — vérifier que l'endpoint SSE accepte les requêtes cross-origin depuis localhost:6274

Vérifier : curl -N <sse_url> avec -H 'Accept: text/event-stream'

L'évaluation s'exécute mais tous les modèles échouent

Vérifier la validité des clés API dans les paramètres ; vérifier que les noms de modèles correspondent à la nomenclature actuelle du fournisseur

Port de l'inspector déjà utilisé

PORT=6275 npx @mcpjam/inspector

Vérifier : lsof -i :6274

Alternatives

MCPJam Inspector vs autres

Alternative	Quand l'utiliser	Compromis
modelcontextprotocol/inspector (officiel)	Vous voulez l'inspector de référence avec le jeu de fonctionnalités le plus conservateur	Pas de modes chat/eval ; plus bas niveau
wong2/mcp-cli	Vous préférez le terminal à une interface graphique	Pas de comparaison visuelle d'évaluation ni de rendu de schéma

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills