MCP Inspector
Herramienta interactiva oficial para probar, inspeccionar y validar servidores MCP. Testing visual y debugging en tiempo real.
¿Qué es el MCP Inspector?
El MCP Inspector es una herramienta oficial desarrollada por Anthropic que proporciona una interfaz web interactiva para probar y depurar servidores MCP. Permite inspeccionar mensajes JSON-RPC, probar recursos y herramientas, y validar que tu servidor funciona correctamente antes de integrarlo con clientes reales.
Visual
Interfaz web intuitiva para interactuar con tu servidor sin escribir código.
Tiempo Real
Observa todos los mensajes JSON-RPC mientras ocurren, con timestamps y formato claro.
Completo
Prueba recursos, herramientas y prompts desde una sola interfaz.
Características Principales
El Inspector proporciona todas las herramientas necesarias para probar y validar servidores MCP.
Inspección en Tiempo Real
Visualiza todos los mensajes JSON-RPC que se intercambian entre el cliente y el servidor en tiempo real.
- Request y Response visibles
- Timestamps de cada mensaje
- Formato JSON formateado
- Búsqueda y filtrado de mensajes
Prueba de Recursos
Lista, lee y busca recursos directamente desde la interfaz. Valida que tus recursos funcionan correctamente.
- Listar todos los recursos
- Leer contenido de recursos
- Buscar recursos por query
- Validar URIs y metadatos
Prueba de Herramientas
Ejecuta herramientas con parámetros personalizados y visualiza los resultados inmediatamente.
- Listar herramientas disponibles
- Ejecutar herramientas con parámetros
- Validar esquemas de entrada
- Ver resultados estructurados
Validación de Prompts
Prueba prompts con diferentes argumentos y valida que generan los mensajes esperados.
- Listar prompts disponibles
- Obtener prompts con argumentos
- Validar estructura de mensajes
- Probar diferentes combinaciones
Instalación y Uso
Instala el Inspector y comienza a probar tu servidor MCP en minutos.
Instalación
Instala el Inspector globalmente o úsalo como dependencia de desarrollo
# Instalación global npm install -g @modelcontextprotocol/inspector # O como dependencia de desarrollo npm install -D @modelcontextprotocol/inspector
Uso Básico
Ejecuta el Inspector con el comando de tu servidor MCP
# Servidor Python mcp-inspector --server "python -m my_server" # Servidor TypeScript/Node.js mcp-inspector --server "node server.js" # Con argumentos adicionales mcp-inspector --server "python -m my_server" --args "--config config.json"
Modo Interactivo
El Inspector abre una interfaz web interactiva en tu navegador
# Al ejecutar, el Inspector: # 1. Inicia el servidor MCP especificado # 2. Abre una interfaz web en http://localhost:3000 # 3. Permite interactuar con el servidor visualmente # Navega a la URL mostrada en la terminal # Ejemplo: http://localhost:3000
Testing y Validación
Escenarios de prueba comunes para validar que tu servidor MCP funciona correctamente.
Validar Inicialización
Verifica que el servidor se inicializa correctamente y reporta sus capacidades.
Pasos:
- 1Ejecuta el Inspector con tu servidor
- 2Observa el mensaje 'initialize' en la pestaña de mensajes
- 3Verifica que la respuesta incluye las capacidades correctas
- 4Confirma que 'initialized' se envía correctamente
Resultado Esperado:
El servidor debe reportar sus capacidades (resources, tools, prompts) correctamente.
Probar Lista de Herramientas
Valida que todas las herramientas están disponibles y tienen esquemas válidos.
Pasos:
- 1Navega a la sección 'Tools' en el Inspector
- 2Haz clic en 'List Tools'
- 3Revisa que todas las herramientas aparecen
- 4Verifica que cada herramienta tiene nombre, descripción y inputSchema
Resultado Esperado:
Todas las herramientas deben aparecer con sus metadatos completos.
Ejecutar una Herramienta
Prueba ejecutar una herramienta con diferentes parámetros.
Pasos:
- 1Selecciona una herramienta de la lista
- 2Completa el formulario con los parámetros requeridos
- 3Haz clic en 'Call Tool'
- 4Revisa la respuesta en el panel de resultados
Resultado Esperado:
La herramienta debe ejecutarse y retornar un resultado válido.
Validar Recursos
Verifica que los recursos se pueden listar, leer y buscar correctamente.
Pasos:
- 1Ve a la sección 'Resources'
- 2Haz clic en 'List Resources'
- 3Selecciona un recurso y haz clic en 'Read'
- 4Prueba la búsqueda con diferentes queries
Resultado Esperado:
Los recursos deben ser accesibles y retornar contenido válido.
Interfaz del Inspector
Descripción de las secciones principales de la interfaz web del Inspector
Panel de Mensajes
Muestra todos los mensajes JSON-RPC intercambiados entre el cliente y el servidor. Puedes ver requests, responses y errores con timestamps y formato JSON formateado.
Sección de Recursos
Permite listar todos los recursos disponibles, leer el contenido de recursos específicos y buscar recursos usando queries. Valida URIs y metadatos.
Sección de Herramientas
Lista todas las herramientas disponibles y permite ejecutarlas con parámetros personalizados. Incluye validación de esquemas y visualización de resultados.
Sección de Prompts
Prueba prompts con diferentes argumentos y valida que generan los mensajes esperados. Útil para validar plantillas de prompts reutilizables.
Mejores Prácticas para Testing
Antes de Integrar
- Prueba todos los recursos disponibles
- Valida que todas las herramientas funcionan
- Verifica los esquemas de entrada
- Comprueba el manejo de errores
- Prueba con parámetros inválidos
Durante el Desarrollo
- Usa el Inspector para desarrollo iterativo
- Valida cambios inmediatamente
- Revisa los mensajes JSON-RPC para debugging
- Prueba casos límite y edge cases
- Documenta comportamientos esperados
¿Listo para probar tu servidor?
Instala el Inspector y comienza a validar tu servidor MCP. Explora más recursos y guías.