Cargando
Cargando

Al construir servidores MCP, necesitas una forma de probar tu funcionalidad sin conectarte a una aplicación completa. El SDK de MCP para Python incluye un inspector integrado basado en navegador que te permite depurar y probar tu servidor en tiempo real.

Iniciar el inspector

Primero, asegúrate de que tu entorno de Python esté activado (revisa el README de tu proyecto para conocer el comando exacto). Luego ejecuta el inspector con:

bash
mcp dev mcp_server.py

Esto inicia un servidor de desarrollo en el puerto 6277 y te proporciona una URL local para abrir en tu navegador. Se cargará la interfaz del inspector, mostrando el panel del MCP Inspector.

Panel del MCP Inspector antes de conectar: tipo de transporte STDIO, comando uv, un botón "Connect" y estado "Disconnected".

Nota importante sobre la interfaz

Las imágenes aquí y el video muestran la versión 1 del inspector, pero mcp dev ahora inicia la versión 2, que necesita Node.js 22.19 o posterior. En la versión 2, activas el interruptor en la tarjeta de tu servidor en lugar de hacer clic en "Connect", la pestaña Tools muestra tus herramientas sin un botón "List Tools", y "Run Tool" se llama "Execute Tool".

Conectar y probar herramientas

Haz clic en el botón "Connect" en el lado izquierdo para iniciar tu servidor MCP. Una vez conectado, verás una barra de navegación con secciones para Resources, Prompts, Tools y otras funciones.

Inspector MCP después de conectarse, mostrando el estado Connected y las pestañas Resources, Prompts, Tools, Ping, Sampling y Roots.

Para probar tus herramientas:

  • Navega a la sección Tools
  • Haz clic en "List Tools" para ver todas las herramientas disponibles
  • Selecciona una herramienta para abrir su interfaz de prueba
  • Completa los parámetros requeridos
  • Haz clic en "Run Tool" para ejecutar y ver los resultados

Pestaña Tools del MCP Inspector que muestra las herramientas read_doc_contents y edit_document, cada una con una breve descripción.

Probar operaciones de documentos

Por ejemplo, para probar una herramienta de lectura de documentos, introducirías un ID de documento (como "deposition.md") y ejecutarías la herramienta. El inspector muestra el resultado, incluyendo cualquier contenido devuelto o mensajes de éxito.

Resultado del MCP Inspector para read_doc_contents en "deposition.md": "Success" y texto que comienza con "A report deposition covers".

Puedes encadenar operaciones para verificar la funcionalidad. Por ejemplo, después de editar un documento reemplazando texto, puedes ejecutar inmediatamente la herramienta de lectura de nuevo para confirmar que los cambios se aplicaron correctamente.

Flujo de trabajo de desarrollo

El inspector crea un bucle de desarrollo eficiente:

  • Haz cambios en el código de tu servidor MCP
  • Prueba herramientas individuales a través del inspector
  • Verifica los resultados sin necesitar una configuración completa de la aplicación
  • Depura problemas de forma aislada

Esta herramienta se vuelve esencial a medida que construyes servidores MCP más complejos. Elimina la necesidad de conectar tu servidor a Claude u otra aplicación solo para probar la funcionalidad básica, haciendo que el desarrollo sea mucho más rápido y enfocado.