Ispeziona, esegui il debug e testa visivamente i server Model Context Protocol (MCP) da un'interfaccia web, CLI o TUI, con esplorazione di strumenti/risorse, registrazione delle richieste e supporto OAuth.
Uno strumento per sviluppatori per ispezionare i server Model Context Protocol (MCP). Viene distribuito come un singolo pacchetto, @modelcontextprotocol/inspector, che fornisce quattro modi per ispezionare un server:
clients/mcpdo.I primi tre funzionano tramite un unico binario globale mcp-inspector; mcpdo è un secondo binario nello stesso pacchetto:
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 gestisce i segreti — token OAuth, client secret OAuth e valori
env:di stdio — e li archivia nell'keychain del sistema operativo, se disponibile, per impostazione predefinita. Su una macchina senza keychain — Linux senza libsecret o un Secret Service, sessioni headless e SSH, Termux e container con un volume montato — vengono invece salvati in~/.mcp-inspector/secrets.json, non crittografati a meno che tu non fornisca una chiave. Consulta Dove vengono archiviati i segreti per sapere come ripristinare un keychain, crittografare il file o mantenere i segreti solo in memoria.
Stai eseguendo l'aggiornamento da v1? Leggi la guida alla migrazione da v1 a v2 — flag CLI, la nuova suddivisione tra
--confige--catalog, l'innalzamento del motore Node e cosa non viene più distribuito.
Stato del repository. Questa è la linea v2 dell'Inspector. Lo sviluppo attivo avviene su
v2/main(il branch di sviluppo — tutte le PR v2 sono destinate ad esso), che viene unito inmainin occasione delle release milestone;mainè il branch predefinito e contiene l'ultima v2 rilasciata, pubblicata sul tag npmlatest. La linea legacy v1 risiede suv1/main— solo correzioni di sicurezza, pubblicate direttamente da quel branch sul tag npmv1-latest(npx @modelcontextprotocol/inspector@v1-latest). ConsultaAGENTS.mdper le convenzioni su branch e board.
Richiede Node ^22.23.4 || ^24.22.1 || >=26.12.1: la release con patch su ciascuna linea supportata.
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
Per l'iterazione quotidiana sul web, esegui Vite direttamente — HMR veloce, nessuna build del launcher necessaria:
cd clients/web && npm run dev
Gli script avviati dal launcher eseguono il launcher compilato, quindi compila prima:
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
La v2 non è un workspace npm — ogni client sotto clients/* mantiene il proprio package.json e node_modules, e il codice condiviso risiede in core/, consumato tramite un alias di build @inspector/core. Ogni dipendenza runtime importata da core/ è dichiarata una sola volta, nel package.json alla radice del repository, e ogni client dichiara solo ciò che consuma esclusivamente per sé — il proprio stack UI, i propri pacchetti inlinati dal bundler, i propri strumenti di sviluppo — il che lascia clients/cli e clients/launcher senza dipendenze runtime proprie. Cosa questo comporti per l'aggiunta di una dipendenza (root vs. client, dependencies vs. devDependencies, e le liste external del bundler) è descritto nella skill 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
Ogni client ha il proprio README con dettagli specifici del client: web · cli · mcpdo · tui · launcher.