MCP INSPECTOR: LA HERRAMIENTA ESENCIAL PARA PROBAR Y DEPURAR SERVIDORES MCP

El Model Context Protocol, o MCP, se ha convertido en el estándar de facto para conectar LLMs, con herramientas, datos y recursos externos. Permite que asistentes como Claude, Cursor o VS Code accedan de forma estructurada a funciones personalizadas, archivos, bases de datos o APIs.
Sin embargo, desarrollar un servidor MCP no siempre es sencillo. Errores de protocolo, problemas de transporte, herramientas que no aparecen o respuestas mal formadas pueden hacer perder horas. Aquí es donde entra MCP Inspector, la herramienta oficial de referencia del proyecto Model Context Protocol para probar y depurar servidores MCP.

¿Qué es MCP Inspector?

MCP Inspector es un cliente de desarrollo interactivo diseñado específicamente para servidores MCP. Permite conectar con tu servidor MP, listar y ejecutar herramientas, inspeccionar recursos y prompts, y observar el tráfico de protocolo en tiempo real, sin necesidad de un host de IA completo.
Se distribuye como un único paquete npm, "@modelcontextprotocol/inspector" y ofrece tres interfaces sobre el mismo núcleo:

Cliente Cómo se invoca Uso principal
Web (por defecto) "npx @modelcontextprotocol/inspector" Interfaz gráfica completa en el navegador
CLI "npx @modelcontextprotocol/inspector --cli" Modo scriptable para CI, pipelines y agentes
TUI "npx @modelcontextprotocol/inspector --tui" Interfaz de terminal interactiva


Todas comparten los mismos transportes, archivos de configuración y comportamiento de protocolo.

Requisitos y arranque rápido

  • NodeJS 22.19.0 o superior, versiones recientes.
  • No requiere instalación global: se ejecuta directamente con npx.

Ejemplos básicos:

# Lanzar la interfaz web vacía (añades servidores desde la UI)
npx @modelcontextprotocol/inspector

# Conectar a un servidor local stdio (Node.js)
npx @modelcontextprotocol/inspector node path/to/server/index.js

# Servidor Python
npx @modelcontextprotocol/inspector python server.py

# Servidor publicado en npm
npx -y @modelcontextprotocol/inspector npx @modelcontextprotocol/server-filesystem /ruta/a/carpeta
Al ejecutarlo, se muestra una URL con un token de sesión único, normalmente en "http://localhost:6274". Se debe abrir exactamente esa URL; no escribir la dirección de memoria por motivos de seguridad.
También existe una imagen Docker oficial:

docker run --rm -p 6274:6274 ghcr.io/modelcontextprotocol/inspector

Arquitectura

  • MCP Inspector consta de dos componentes principales:
  • MCP Inspector Client: interfaz web React que se ejecuta en el navegador.
  • MCP Proxy: servidor NodeJS que actúa como puente. Se conecta al servidor MCP mediante el transporte correspondiente, como stdio, SSE o Streamable HTTP, y al mismo tiempo, sirve la interfaz web.
El proxy no intercepta tráfico de red de forma general; es un cliente MCP completo que permite la interacción desde el navegador.

Características principales

  • Panel de conexión: selección de transporte, como stdio, SSE, HTTP, argumentos, variables de entorno y cabeceras personalizadas.
  • Pestaña Tools: lista todas las herramientas, muestra esquemas de entrada, permite ejecutarlas con parámetros y ver respuestas completas en JSON.
  • Pestaña Resources: exploración de recursos, metadatos, como MIME types, descripciones, y contenido. Soporte para suscripciones.
  • Pestaña Prompts: visualización de plantillas de prompts y sus argumentos.
  • Monitor de tráfico / Notificaciones: mensajes JSON-RPC en tiempo real, errores y logs de consola, especialmente útil para servidores stdio, cuyos mensajes de stderr aparecen aquí.
  • Soporte de OAuth y autenticación.
  • Exportación de configuraciones en formato "mcp.json" para usar en clientes como Claude Desktop, Cursor o VS Code. Modo CLI para automatización: listar herramientas, invocarlas, comprobar recursos, etc.

Casos de uso típicos

  • Verificar que las herramientas se registran correctamente antes de conectarlas a un LLM.
  • Depurar por qué una herramienta no aparece o falla con ciertos parámetros.
  • Probar servidores remotos HTTP/SSE.
  • Validar el cumplimiento del protocolo, versiones legacy vs. modernas.
  • Integrar pruebas automatizadas en pipelines de CI.
  • Inspeccionar el comportamiento exacto del protocolo sin la complejidad de un agente completo.

Consejos prácticos

  • Usar "--" para separar argumentos del Inspector de los del servidor:

    npx @modelcontextprotocol/inspector node build/index.js -- --verbose --config config.json
  • Pasar variables de entorno con "-e":

    npx @modelcontextprotocol/inspector -e API_KEY=abc123 node server.js
  • Si la conexión falla sin mensaje claro, primerorevisar la pestaña "Console": muchos servidores escriben diagnósticos en "stderr".
  • El token de sesión protege el proxy local, ya que puede lanzar procesos en la máquina.
Alternativas y ecosistema Existen herramientas de terceros como MCPJam Inspector, con emulador de widgets y playground de LLM, o versiones hospedadas, pero MCP Inspector oficial sigue siendo la referencia para comprobar el cumplimiento del protocolo y para uso en desarrollo y CI.

Conclusión

MCP Inspector es una herramienta indispensable para cualquier desarrollador que construya o mantenga servidores MCP. Reduce drásticamente el ciclo de prueba-error, ofrece visibilidad completa del protocolo y permite validar el comportamiento de forma aislada y reproducible.
Si se están desarrollando servidores MCP, empezat siempre por el Inspector: si funciona aquí, funcionará en Claude, Cursor u otros clientes. Si no funciona aquí, el problema está en el servidor, no en la configuración del cliente. Enlaces útiles: