/ Directorio / 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 qué usarlo

Características clave

Demo en vivo

Cómo se ve en la práctica

listo

Instalar

Elige tu 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"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

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

Continue usa un array de objetos de servidor en lugar de un mapa.

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: MCP Inspector

Debug your MCP server without involving an LLM

👤 Developers ⏱ ~15 min intermediate

Cuándo usarlo: Claude says 'tool failed' and you need to see what really happened.

Flujo
  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.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

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

Herramientas

Lo que expone este MCP

HerramientaEntradasCuándo llamarCoste
tools.call (see docs) Invoke any tool the server advertises 1 call
resources.list (see docs) Browse resources 1 call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API
N/A
Tokens por llamada
N/A
Monetario
Free OSS
Consejo
Save common invocations as bookmarks

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Local only
Salida de datos: Whatever the server reaches
No conceder nunca: Run untrusted MCP servers against your auth tokens

Resolución de problemas

Errores comunes y soluciones

Server won't connect

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

Alternativas

MCP Inspector vs otros

AlternativaCuándo usarlaContrapartida
mcp2cliYou prefer command-lineNo GUI for protocol inspection

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills