Inspectez, déboguez et testez visuellement les serveurs Model Context Protocol (MCP) depuis une interface web, une CLI ou une TUI, avec exploration des outils/ressources, journalisation des requêtes et prise en charge d'OAuth.
Un outil de développement pour inspecter les serveurs Model Context Protocol (MCP). Il est distribué sous forme d'un paquet unique, @modelcontextprotocol/inspector, qui offre quatre façons d'inspecter un serveur :
clients/mcpdo.Les trois premiers s'exécutent via un binaire global mcp-inspector ; mcpdo est un second binaire dans le même paquet :
npx @modelcontextprotocol/inspector # web UI (default)
npx @modelcontextprotocol/inspector --cli # CLI
npx @modelcontextprotocol/inspector --tui # TUI
npx -p @modelcontextprotocol/inspector mcpdo --help # mcpdo
[!WARNING] L'Inspector gère les secrets — jetons OAuth, secrets clients OAuth et valeurs
env:de stdio — et les stocke par défaut dans le trousseau du système d'exploitation, s'il est disponible. Sur une machine sans trousseau — Linux sans libsecret ni Secret Service, sessions sans interface graphique et SSH, Termux, et conteneurs avec un volume monté — ils sont enregistrés dans~/.mcp-inspector/secrets.jsonà la place, non chiffrés sauf si vous fournissez une clé. Consultez Où les secrets sont stockés pour savoir comment récupérer un trousseau, chiffrer le fichier ou conserver les secrets uniquement en mémoire.
Vous migrez depuis la v1 ? Lisez le guide de migration v1 → v2 — les options CLI, la nouvelle séparation
--configvs.--catalog, la mise à niveau du moteur Node, et ce qui n'est plus livré.
Statut du dépôt. Il s'agit de la lignée v2 de l'Inspector. Le développement actif se fait sur
v2/main(la branche de développement — toutes les PR v2 la ciblent), qui est fusionnée dansmainlors des versions jalons ;mainest la branche par défaut et contient la dernière v2 publiée, publiée sous le tag npmlatest. La lignée historique v1 vit surv1/main— correctifs de sécurité uniquement, publiés directement depuis cette branche sous le tag npmv1-latest(npx @modelcontextprotocol/inspector@v1-latest). ConsultezAGENTS.mdpour les conventions de branches et de tableau.
Nécessite Node ^22.23.4 || ^24.22.1 || >=26.12.1 : la version corrigée sur chaque lignée prise en charge.
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
Pour l'itération web au quotidien, exécutez Vite directement — HMR rapide, aucune compilation du lanceur nécessaire :
cd clients/web && npm run dev
Les scripts pilotés par le lanceur exécutent le lanceur compilé, il faut donc compiler d'abord :
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
v2 n'est pas un workspace npm — chaque client sous clients/* conserve son propre package.json et son propre node_modules, et le code partagé réside dans core/, consommé via un alias de build @inspector/core. Chaque dépendance d'exécution importée par core/ est déclarée une seule fois, dans le package.json à la racine du dépôt, et chaque client ne déclare que ce que ce client consomme seul — sa pile UI, ses paquets intégrés par le bundler, ses outils de développement — ce qui laisse clients/cli et clients/launcher sans aucune dépendance d'exécution propre. Ce que cela implique pour l'ajout d'une dépendance (racine vs. client, dependencies vs. devDependencies, et les listes external du bundler) est décrit dans la compétence local-dev.
inspector/
├── clients/
│ ├── web/ Web client (Vite + React + Mantine). src/ = browser app; server/ = Node backend
│ ├── cli/ CLI client (tsdown bundle, @inspector/core alias)
│ ├── mcpdo/ Experimental connection CLI (`mcpdo` bin) — bundled into the
│ │ published package; see clients/mcpdo/README.md
│ ├── tui/ TUI client (Ink + React, tsdown bundle)
│ └── launcher/ Shared launcher — provides the `mcp-inspector` bin, dispatches to web/cli/tui
├── core/ Shared code consumed via the `@inspector/core` alias (no package.json)
├── test-servers/ Composable MCP test servers + fixtures used by integration and smoke tests
├── scripts/ Root build/verify tooling (install cascade, smokes, the verify:* guards),
│ repo automation run from CI (the dependency, Dependabot-alert and SDK sweeps),
│ maintainer-workflow helpers (the pr:*, board:*, advisory:*,
│ release:notes, release:tag and action:resolve-pin aliases)
│ and the Docker image's HEALTHCHECK probe
├── docs/ Task-oriented guides — see below
├── specification/ Design/build specifications
├── skills/ End-user agent skills (e.g. skills/mcpdo teaches an agent to
│ drive the `mcpdo` CLI) — distinct from .claude/skills/,
│ which holds this repo's own procedures
├── .claude/skills/ Agent skills: the repo's procedures, invokable by name
├── AGENTS.md Contribution rules for agents AND humans
└── README.md You are here
Chaque client dispose de son propre README avec des détails spécifiques au client : web · cli · mcpdo · tui · launcher.