Depuración de servidores LLM sin quebraderos de cabeza con MCP Inspector
¿Conoces esa sensación cuando intentas que un agente de IA funcione con tu API local, y o bien se congela o escupe algún error críptico? Te quedas ahí preguntándote: ¿está roto el prompt, se colgó el servidor, o los datos llegan en el formato incorrecto? Historia conocida. Los desarrolladores de Anthropic parecen haber pasado por lo mismo, por eso publicaron MCP Inspector.
Se trata de un depurador visual para el Model Context Protocol (MCP). En resumen, MCP es un nuevo estándar que ayuda a los modelos de lenguaje a comunicarse con herramientas externas, bases de datos y sistemas de archivos. E Inspector es básicamente un Postman, pero adaptado específicamente para trabajar con servidores LLM.
Qué hay bajo el capó y cómo funciona
La herramienta consta de dos partes. La primera es un cliente React que ves en el navegador. La segunda es un servidor proxy que se ejecuta en Node.js. Este proxy es la parte más interesante: puede convertir streams de entrada/salida estándar (stdio) o streams HTTP en una interfaz amigable para el navegador.
Muchos servidores MCP funcionan a través de entrada/salida de consola regular. Un navegador no puede comunicarse directamente con un proceso así, así que el proxy actúa como puente: lanza tu servidor, intercepta sus mensajes y los transmite a la interfaz web.
Cómo empezar rápidamente
Si tienes Node.js versión 22.7.5 o superior, simplemente escribe en tu terminal:
npx @modelcontextprotocol/inspector
El comando levantará una interfaz web en http://localhost:6274. Por cierto, las opciones de puerto aquí son curiosas: 6274 corresponde a los botones MCPI (MCP Inspector) en un teléfono antiguo con teclado.
Si estás construyendo tu propio servidor, puedes apuntar el inspector directamente a él:
npx @modelcontextprotocol/inspector node build/index.js
El inspector detectará el build, pasará los argumentos necesarios y abrirá el navegador con todas tus herramientas y recursos visibles.
Qué puede hacer este depurador
El principal atractivo del inspector es su interactividad. No necesitas escribir scripts para probar cada función.
Primero, está la prueba de herramientas. Ves una lista de todas las funciones que el servidor expone al modelo. Puedes rellenar los argumentos directamente en el formulario (sin JSON manual en la consola) y pulsar "Call Tool". La respuesta llega al instante, y puedes ver inmediatamente si la estructura de datos "se desplazó" o se estropeó.
Segundo, está la navegación de recursos. Si tu servidor proporciona acceso a archivos o logs, puedes explorarlos en una interfaz de árbol en el inspector. Esto es un salvavidas cuando necesitas entender exactamente qué contexto está recibiendo el modelo.
Tercero, está el manejo de prompts. Puedes probar las plantillas de prompt integradas en el servidor y ver cómo se rellenan con datos en tiempo real.
Seguridad y matices
Los desarrolladores no pusieron esa enorme advertencia en el README por nada. La esencia es que el servidor proxy tiene derecho a lanzar procesos en tu máquina. Si simplemente abres su puerto a internet, cualquiera puede ejecutar código arbitrario.
Por defecto, el inspector genera un token de sesión aleatorio. Se ve así:
http://localhost:6274/?MCP_PROXY_AUTH_TOKEN=ваш_длинный_хеш
No recomendaría desactivar esta verificación con el flag DANGEROUSLY_OMIT_AUTH, aunque seas demasiado perezoso para copiar el enlace. Ha habido casos (CVE-2025-49596) donde puertos tan abiertos podrían llevar a RCE simplemente visitando un sitio malicioso en otra pestaña del navegador.
Cuándo usarlo
Para mí, el mayor descubrimiento fue el modo CLI. Es perfecto para emparejarlo con Cursor u otros asistentes de codificación con IA. Puedes ejecutar un comando:
npx @modelcontextprotocol/inspector --cli node build/index.js --method tools/list
Y obtener JSON limpio con una lista de herramientas. Esto acelera el ciclo "escribí código — probé — corregí" por leaps and bounds.
El inspector definitivamente será útil si:
- Estás construyendo un servidor MCP personalizado para tu empresa.
- Estás intentando conectar Claude Desktop con una base de datos local.
- Estás depurando cadenas complejas de llamadas a herramientas donde el orden de los argumentos importa.
La herramienta resultó ser sorprendentemente sólida para ser un protocolo tan joven. Sí, la documentación todavía es un poco escasa, y la interfaz se ve básica, pero destaca en su trabajo — "mostrarte qué hay bajo el capó de un servidor LLM".
Si planeas integrar agentes de IA en tus flujos de trabajo, marca este repositorio. Te ahorrará muchas horas depurando campos faltantes en esquemas JSON o rutas de archivos incorrectas.
Proyectos relacionados