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.
Iniciando el Inspector
Primero, asegúrate de que tu entorno de Python esté activado (consulta el README de tu proyecto para el comando exacto). Luego ejecuta el inspector con:
mcp dev mcp_server.pyEsto inicia un servidor de desarrollo en el puerto 6277 y te proporciona una URL local para abrir en tu navegador. La interfaz del inspector se cargará, mostrando el panel del MCP Inspector.
Nota Importante Sobre la Interfaz
El inspector de MCP está en desarrollo activo, por lo que la interfaz que ves podría verse diferente de las capturas de pantalla actuales. Sin embargo, la funcionalidad principal para probar herramientas, recursos e indicaciones debería permanecer similar.
Conectando y Probando 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.
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
Probando Operaciones de Documentos
Por ejemplo, para probar una herramienta de lectura de documentos, ingresarí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.
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 ciclo de desarrollo eficiente:
- Realiza cambios en el código de tu servidor MCP
- Prueba herramientas individuales a través del inspector
- Verifica los resultados sin necesidad de configurar una aplicación completa
- 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.