Al construir servidores MCP, necesitas una forma de probar tu funcionalidad sin conectarte a una aplicación completa. El SDK de Python para MCP 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 y te proporciona una URL local (típicamente en el puerto 6277) para acceder al inspector en tu navegador.
Usando la Interfaz del Inspector
El inspector de MCP está en desarrollo activo, por lo que la interfaz puede verse diferente cuando lo uses. Sin embargo, la funcionalidad principal permanece consistente.
Después de hacer clic en "Connect" para iniciar tu servidor MCP, verás una barra de navegación con secciones para:
- Resources
- Prompts
- Tools
- Otras capacidades del servidor
Probando tus Herramientas
La sección Tools es donde pasarás la mayor parte de tu tiempo de depuración. Haz clic en "List Tools" para ver todas las herramientas que proporciona tu servidor.
Cuando seleccionas una herramienta, el panel derecho muestra sus detalles y proporciona campos de entrada para realizar pruebas. Por ejemplo, para probar la herramienta read_doc_contents:
- Selecciona la herramienta de la lista
- Ingresa un ID de documento (como "deposition.md")
- Haz clic en "Run Tool"
- Verifica los resultados para confirmar el éxito y la salida esperada
Probando Interacciones entre Herramientas
Puedes probar múltiples herramientas en secuencia para verificar que funcionan correctamente juntas. Por ejemplo, después de usar la herramienta edit_document para modificar contenido:
Ejecuta la herramienta read_doc_contents nuevamente con el mismo ID de documento para confirmar que tus cambios se aplicaron:
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 con varias entradas
- Verifica que las interacciones entre herramientas funcionen como se espera
- Depura problemas sin necesidad de configurar una aplicación completa
Este entorno de pruebas basado en navegador es esencial para el desarrollo de servidores MCP. Ahorra tiempo al permitirte detectar problemas temprano y verificar la funcionalidad antes de integrarte con Claude u otras aplicaciones.