Antes de conectar un servidor MCP con una herramienta de inteligencia artificial real, es importante verificar que el servidor está correctamente construido y responde como esperamos. MCP Inspector con FastMCP nos ayuda en este paso intermedio al ser una herramienta que simula el comportamiento de una IA y permite inspeccionar las tools del servidor, ejecutarlas manualmente, y revisar los mensajes que se intercambian. En esta clase ejecutaremos el inspector sobre el servidor que construimos previamente y veremos cómo se comunica con FastMCP.
Cuando integramos un servidor MCP directamente con una herramienta de IA, perdemos visibilidad sobre lo que ocurre por debajo. Si algo falla, la IA simplemente responde con un mensaje genérico o reintenta sin explicar qué provocó el error. El MCP Inspector resuelve este problema actuando como un cliente MCP de prueba: nos muestra las tools que ofrece el servidor, nos permite ejecutarlas manualmente y nos enseña exactamente qué mensajes viajan en cada dirección. Veremos en la clase cómo se conecta el inspector al servidor y cómo interpretar la información que muestra en cada pestaña. También hablaremos sobre las ventajas de implementarlo, y veremos cómo cada operación tiene un mensaje específico del protocolo MCP que FastMCP genera automáticamente por debajo.
if __name__ == "__main__"Acá desarrollaremos un concepto que no es muy conocido para ingenieros de redes que no están en el mundo del desarrollo de aplicaciones. Cuando ejecutamos un archivo Python directamente, una variable interna llamada __name__ toma un valor específico que es diferente a cuando se realiza la ejecución de código a través del «import». Si no consideramos el valor de esa variable, esto va provocar fallos en las pruebas del servidor MCP a través del inspector. Así que realizaremos diferentes pruebas para que este concepto quede claro.
Finalmente trabajaremos directamente con el inspector al ejecutar el comando fastmcp dev inspector sobre nuestro archivo Python. Una vez levantado el servidor de inspección, accederemos al cliente web que se abre en el navegador, lo conectaremos al servidor MCP, y procederemos a listar las tools disponibles para verificar que la función desarrollada en la clase anterior aparezca correctamente con su nombre y descripción. También analizaremos los mensajes intercambiados, el formato de los mensajes, y el return devuelto por la función creada.
Para esta clase sí son requeridos conocimientos básicos de Python.
Como siempre, si te queda alguna duda de la clase, introducela en los comentarios y te ayudamos. ¡Te vemos dentro de la clase!
No es obligatorio en términos técnicos, pero sí es una buena práctica fuertemente recomendada. Cuando integramos directamente el servidor con una IA, los errores se vuelven mucho más difíciles de diagnosticar porque la IA no proporciona detalles técnicos sobre lo que falla. El inspector permite aislar problemas de código antes de añadir la capa de complejidad que representa la integración con un modelo de lenguaje.
El flujo de mensajes entre cliente y servidor es idéntico en ambos casos. La diferencia está en quién decide qué tool ejecutar. En el inspector lo decide manualmente el usuario, mientras que con una IA real es el modelo de lenguaje quien interpreta la consulta del usuario, lee las descripciones de las tools disponibles y elige cuál invocar. En la clase mostramos esa correspondencia exacta para que la transición posterior a una integración real resulte mucho más predecible.