inspector MCP — Cas d'usage, Installer & Démo en direct

Name: inspector MCP Server
Author: MCPJam

Pourquoi l'utiliser

Fonctionnalités clés

Traçage JSON-RPC complet entre l'hôte et le serveur
Chat LLM en ligne lors de l'inspection des appels d'outils et du contexte
Exécutions d'évaluation sur plusieurs modèles
Débogage du flux OAuth avec vérifications de conformité
Partage d'espace de travail, CLI, SDK et intégration CI/CD

Démo en direct

Aperçu en pratique

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": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

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": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "inspector"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json

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

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

~/.config/zed/settings.json

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

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

claude mcp add inspector -- npx -y inspector

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

Cas d'usage

Usages concrets : inspector

Comment déboguer pourquoi votre outil MCP n'est pas appelé

👤 Développeurs de serveurs MCP ⏱ ~15 min intermediate

Quand l'utiliser : Vous avez écrit un outil, Claude ne l'utilise pas, et vous ne savez pas pourquoi.

Prérequis

Node — nodejs.org ou nvm

Déroulement

Lancez Inspector

Exécutez npx @mcpjam/inspector@latest et ouvrez l'URL affichée.✓ Copié

→ L'interface utilisateur s'ouvre dans le navigateur
Connectez votre serveur

Dans l'interface utilisateur, ajoutez votre serveur (stdio ou HTTP) et connectez-vous.✓ Copié

→ La liste des outils est remplie
Simulez une invite

Dans l'onglet Chat, posez une question qui devrait déclencher votre outil. Observez la trace JSON-RPC.✓ Copié

→ Soit l'outil s'exécute (bon), soit vous voyez pourquoi le modèle l'a rejeté (mauvaise description, schéma d'entrée manquant)

Résultat : Raison concrète (mauvaise description d'outil, problème de schéma, choix du modèle) avec une correction visible.

Pièges

Tester avec un modèle plus faible qui n'utilise jamais les outils — Testez sur plusieurs modèles dans l'onglet Evals — Haiku, Sonnet, GPT-4o — le comportement varie

Comment exécuter des tests d'évaluation sur les PR pour votre serveur MCP

👤 Équipes maintenant les MCP en production ⏱ ~30 min advanced

Quand l'utiliser : Vous voulez détecter « oups, ce prompt ne choisit plus mon outil » dans CI.

Déroulement

Créez les évaluations

Dans Inspector, créez des cas d'évaluation : (invite, outil_attendu_appelé, arguments_attendus).✓ Copié

→ Suite d'évaluation enregistrée
Intégrez à CI

Utilisez la CLI pour exécuter les évaluations sur chaque PR; échouez la compilation en cas de régression.✓ Copié

→ .github/workflows/mcp-eval.yml exécute les évaluations

Résultat : Les PR qui cassent la sélection d'outils ne fusionnent pas.

Pièges

Les évaluations sont instables quand la température > 0 — Utilisez la température 0 dans les exécutions d'évaluation

Combiner avec : github

Comment diagnostiquer un flux OAuth cassé sur votre serveur MCP

👤 Développeurs de serveurs MCP expédiant des outils protégés par OAuth ⏱ ~20 min advanced

Quand l'utiliser : Les jetons ne se rafraîchissent pas ou la redirection retourne 400.

Déroulement

Activez le débogage OAuth dans Inspector

Configurez les points de terminaison OAuth de votre serveur et cliquez sur « Tester le flux ».✓ Copié

→ Trace étape par étape d'autorisation, jeton, rafraîchissement
Identifiez la rupture

Inspector met en évidence les étapes non conformes (type de contenu incorrect, PKCE manquant, mauvaise portée).✓ Copié

→ Nœud d'échec spécifique

Résultat : Implémentation OAuth conforme.

Combinaisons

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

inspector + github

Exécutez les évaluations Inspector dans une action GitHub sur les PR pour votre serveur MCP

Configurez une action GitHub utilisant la CLI @mcpjam/inspector pour exécuter les évaluations sur chaque PR touchant src/tools/.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
(inspector app) connect-server	transport: stdio\|http, command ou url	Première étape	gratuit
(inspector app) execute-tool	tool, args	Tests manuels	dépend de l'outil
(inspector app) chat-and-inspect	model, prompt	Simulation de bout en bout	1 appel LLM
(inspector app) run-evals	suite_id	Tests de régression CI	N appels LLM

Coût et limites

Coût d'exécution

Quota d'API: Vos clés LLM/eval déterminent le budget
Tokens par appel: Les évaluations peuvent consommer des jetons — limitez la concurrence + la taille
Monétaire: Inspector lui-même est gratuit. L'application hébergée sur app.mcpjam.com a des niveaux.
Astuce: Exécutez les évaluations sur Haiku pour des tests de fumée bon marché; réservez Sonnet/Opus pour les exécutions nocturnes.

Sécurité

Permissions, secrets, portée

Portées minimales : Toutes les portées dont votre serveur MCP a besoin Clés de fournisseur LLM pour les évaluations

Stockage des identifiants : Env local pour CLI; secrets d'espace de travail pour l'application hébergée

Sortie de données : Les appels d'outils restent entre votre MCP et LLM; l'application hébergée stocke les résultats d'évaluation dans votre espace de travail

Ne jamais accorder : N'téléchargez pas les secrets clients OAuth en production vers l'application hébergée sans révision

Inspector peut appeler des outils d'écriture lors des exécutions d'évaluation — utilisez un serveur de bac à sable, pas la production.

Dépannage

Erreurs courantes et correctifs

Je ne peux pas me connecter à mon serveur stdio

Assurez-vous que la commande que Inspector exécute correspond à ce que Claude Desktop exécute — répertoire de travail et variables d'env inclus.

L'onglet Chat dit « modèle non configuré »

Ajoutez votre clé Anthropic/OpenAI dans Paramètres.

Les évaluations passent localement, échouent dans CI

Désaccord d'env — épinglez le même modèle + température dans CI qu'en local.

Le test OAuth signale « désaccord d'état »

Votre serveur ne préserve pas le paramètre d'état; comparez à la spécification dans le rapport de conformité d'Inspector.

Alternatives

inspector vs autres

Alternative	Quand l'utiliser	Compromis
@modelcontextprotocol/inspector (officiel)	Vous voulez l'inspecteur de référence de première partie	Surface de fonctionnalités plus petite; pas d'évaluations/CI
mcp-client-for-ollama	Vous voulez un client uniquement terminal soutenu par Ollama	Pas un débogueur, juste un client

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills