Cargando

El inspector del servidor

Lección 524 min
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 (consulta el README de tu proyecto para el comando exacto). Luego ejecuta el inspector con:

bash
mcp dev mcp_server.py

Esto inicia un servidor de desarrollo y te proporciona una URL local (normalmente en el puerto 6277) para acceder al inspector en tu navegador.

Usar la interfaz del Inspector

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 lista tus herramientas sin un botón "List Tools", y "Run Tool" se llama "Execute Tool".

El inspector de MCP antes de conectarse, con transporte de entrada/salida estándar, un botón "Connect" y estado "Disconnected".

Cuando abres el inspector por primera vez, verás un botón "Connect" en el lado izquierdo. Haz clic en este para iniciar tu servidor MCP y cargar tus herramientas.

Probar tus herramientas

Una vez conectado, busca una barra de navegación con secciones como Resources, Prompts y Tools. Haz clic en la sección Tools para ver tus herramientas disponibles.

Haz clic en "List Tools" para ver todas las herramientas que proporciona tu servidor. Cuando selecciones una herramienta específica, el panel derecho se actualiza para mostrar un formulario donde puedes probar esa herramienta.

Ejecutar pruebas de herramientas

Por ejemplo, para probar una herramienta de lectura de documentos:

  • Selecciona la herramienta read_doc_contents
  • Ingresa un ID de documento (como "deposition.md")
  • Haz clic en "Run Tool"

El inspector ejecutará tu herramienta y mostrará los resultados, incluyendo el estado de éxito y cualquier dato devuelto.

Inspector de MCP: read_doc_contents en "deposition.md" muestra Tool Result Success y texto que comienza con "A report deposition covers".

Probar la edición de documentos

También puedes probar herramientas más complejas como la edición de documentos:

  • Cambia a la herramienta edit_document
  • Completa el ID del documento, el texto antiguo a reemplazar y el texto nuevo
  • Ejecuta la herramienta para ver si tiene éxito
  • Usa la herramienta de lectura nuevamente para verificar que los cambios se aplicaron

Formulario edit_document del Inspector de MCP con doc_id deposition.md, old_str "This" y new_str "A report", y Tool Result: Success.

Flujo de trabajo de desarrollo

El inspector muestra un historial de tus llamadas a herramientas en el lado izquierdo, lo que facilita rastrear lo que has probado y repetir operaciones anteriores. Esto crea un bucle de desarrollo eficiente donde puedes:

  • Hacer cambios al código de tu servidor
  • Reiniciar el inspector
  • Probar tus herramientas de inmediato
  • Verificar los resultados

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