/ Diretório / Playground / MCP Inspector
● Oficial modelcontextprotocol ⚡ Instantâneo

MCP Inspector

por modelcontextprotocol · modelcontextprotocol/inspector

The official debugger for MCP servers — connect to any server, call its tools live, see the raw protocol traffic.

MCP Inspector is the canonical dev tool for MCP. Point it at a server (local or remote), enumerate tools and resources, fire calls with structured inputs, and watch frames go by. First thing to reach for when your server misbehaves.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

pronto

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-inspector",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-inspector": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/inspector"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: MCP Inspector

Debug your MCP server without involving an LLM

👤 Developers ⏱ ~15 min intermediate

Quando usar: Claude says 'tool failed' and you need to see what really happened.

Fluxo
  1. Launch
    npx @modelcontextprotocol/inspector ./my-server.✓ Copiado
    → UI opens
  2. Invoke
    Pick the tool; fill inputs; send.✓ Copiado
    → Result + frames shown
  3. Diagnose
    Toggle raw frames to see protocol-level errors.✓ Copiado
    → Root cause clear

Resultado: Server bug isolated without LLM noise.

Combinações

Combine com outros MCPs para 10× de alavancagem

mcp-inspector + fastmcp-prefect

Build a FastMCP server; debug it with the Inspector before shipping

Combine mcp-inspector with fastmcp-prefect: Build a FastMCP server; debug it with the Inspector before shipping✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
tools.call (see docs) Invoke any tool the server advertises 1 call
resources.list (see docs) Browse resources 1 call

Custo e limites

O que custa rodar

Cota de API
N/A
Tokens por chamada
N/A
Monetário
Free OSS
Dica
Save common invocations as bookmarks

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Local only
Saída de dados: Whatever the server reaches
Nunca conceda: Run untrusted MCP servers against your auth tokens

Solução de problemas

Erros comuns e correções

Server won't connect

Check transport (stdio vs SSE); confirm the binary path

Alternativas

MCP Inspector vs. outros

AlternativaQuando usarTroca
mcp2cliYou prefer command-lineNo GUI for protocol inspection

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills