Inspecione, depure e teste visualmente servidores Model Context Protocol (MCP) a partir de uma interface web, CLI ou TUI, com exploração de ferramentas/recursos, registro de requisições e suporte a OAuth.
Uma ferramenta de desenvolvedor para inspecionar servidores Model Context Protocol (MCP). É distribuída como um único pacote, @modelcontextprotocol/inspector, que oferece quatro formas de inspecionar um servidor:
clients/mcpdo.Os três primeiros são executados por meio de um único binário global mcp-inspector; mcpdo é um segundo binário no mesmo pacote:
npx @modelcontextprotocol/inspector # web UI (default)
npx @modelcontextprotocol/inspector --cli # CLI
npx @modelcontextprotocol/inspector --tui # TUI
npx -p @modelcontextprotocol/inspector mcpdo --help # mcpdo
[!WARNING] O Inspector gerencia segredos — tokens OAuth, segredos de cliente OAuth e valores
env:de stdio — e os armazena no keychain do SO, quando disponível, por padrão. Em uma máquina sem keychain — Linux sem libsecret ou um Secret Service, sessões headless e SSH, Termux e contêineres com um volume montado — eles são salvos em~/.mcp-inspector/secrets.json, sem criptografia, a menos que você forneça uma chave. Consulte Onde os segredos são armazenados para saber como recuperar um keychain, criptografar o arquivo ou manter os segredos apenas em memória.
Atualizando da v1? Leia o guia de migração v1 → v2 — flags de CLI, a nova separação entre
--confige--catalog, o aumento da versão do motor Node e o que não é mais distribuído.
Status do repositório. Esta é a linha v2 do Inspector. O desenvolvimento ativo acontece em
v2/main(o branch de desenvolvimento — todos os PRs da v2 têm como alvo esse branch), que é mesclado emmainnas releases de marco;mainé o branch padrão e contém a versão v2 mais recente lançada, publicada na taglatestdo npm. A linha legada v1 vive emv1/main— apenas correções de segurança, publicadas diretamente desse branch para a tagv1-latestdo npm (npx @modelcontextprotocol/inspector@v1-latest). ConsulteAGENTS.mdpara as convenções de branches/boards.
Requer Node ^22.23.4 || ^24.22.1 || >=26.12.1: a versão corrigida em cada linha suportada.
npm install # at the repo root; postinstall cascades into every client
npm run build # web → cli → tui → launcher
Para iteração web do dia a dia, execute o Vite diretamente — HMR rápido, sem necessidade de build do launcher:
cd clients/web && npm run dev
Os scripts acionados pelo launcher executam o launcher compilado, portanto compile primeiro:
npm run web # prod web launcher against clients/web/dist
npm run web:dev # web launcher in --dev mode (Vite)
v2 não é um workspace npm — cada cliente em clients/* mantém seu próprio package.json e node_modules, e o código compartilhado fica em core/, consumido por meio de um alias de build @inspector/core. Toda dependência de runtime que core/ importa é declarada uma única vez, no package.json da raiz do repositório, e cada cliente declara apenas o que consome sozinho — sua stack de UI, seus pacotes embutidos pelo bundler, suas ferramentas de dev — o que deixa clients/cli e clients/launcher sem dependências de runtime próprias. O que isso significa para adicionar uma dependência (raiz vs. cliente, dependencies vs. devDependencies, e as listas external do bundler) está na 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
Cada cliente tem seu próprio README com detalhes específicos do cliente: web · cli · mcpdo · tui · launcher.