0:0010:10

Recursos

Resumen

Configurar tu entorno MCP con Python es más sencillo de lo que parece: no necesitas una instalación tipo Jupyter ni decenas de entornos virtuales. Si estás empezando con el Model Context Protocol y quieres montar tu primer servidor sin complicarte, aquí tienes la ruta mínima para dejarlo corriendo y probarlo con el inspector.

Esta guía es para quienes ya entienden qué resuelve MCP y ahora quieren pasar a la práctica: crear un servidor, agregarle herramientas y recursos, y verificar que todo funciona antes de conectar un cliente.

Qué editor y lenguaje conviene usar para MCP

La primera buena noticia es que no estás atado a una sola herramienta. Puedes usar el editor que mejor conozcas y el lenguaje con el que te sientas cómodo.

Para el editor hay varias opciones válidas:

  • VS Code, que sirve tanto para apps de IA como para desarrollo de software ordinario.
  • Eclipse o Visual Studio, aunque este último se usa cada vez menos.
  • IntelliJ.
  • Claude de Anthropic, que resulta muy compatible con MCP.

Lo mismo ocurre con el lenguaje. Aquí trabajamos con Python, pero no porque sea el lenguaje "oficial" de la inteligencia artificial, sino porque es con el que resulta más cómodo construir servidores MCP [01:05]. Existe un SDK listo para cada opción, así que puedes usar TypeScript, C#, Java o Node sin problema.

¿Necesito Python para trabajar con MCP? No. Hay un SDK disponible para TypeScript, C#, Java y Node. Python se usa aquí solo por comodidad, no por obligación.

Cómo instalar el paquete mcp cli para empezar

El primer paso práctico es preparar el directorio y dejar instalada la línea de comandos de MCP.

  1. Crea la carpeta de trabajo con mkdir clase-tres y entra en ella.
  2. Instala el paquete con pip install "mcp[cli]" [02:28].
  3. Abre el folder en el editor escribiendo code . desde la terminal.

Ese paquete se instala de forma global, así que es básicamente la única vez que tendrás que correr ese comando. A partir de ahí tienes disponible la herramienta de línea de comandos de MCP para todos tus proyectos.

Por ahora trabajamos directamente sobre el entorno, sin crear un entorno virtual. Más adelante conviene usar uno para no alterar toda tu configuración, pero para el primer ejercicio esta ruta mínima es suficiente.

Cómo crear tu primer servidor con FastMCP

Con el paquete instalado, creas un archivo llamado server.py y empiezas a escribir el código base. Gracias a Python, el arranque es muy directo.

La estructura mínima incluye tres piezas:

  • Un import de FastMCP, que llega con el paquete que instalaste.
  • La creación del servidor con algo como mcp = FastMCP("Demo").
  • Los elementos que le agregas: herramientas, recursos y algunos extras.

En este punto el servidor ya tiene dos componentes de ejemplo: una herramienta marcada con mcp.tool y un recurso marcado con mcp.resource [04:29]. Son las dos piezas que luego revisarás con el inspector.

¿Qué diferencia una herramienta de un recurso en MCP? Una herramienta ejecuta una acción, como sumar dos números. Un recurso entrega información o datos, como un saludo con un parámetro de nombre.

Cómo probar el servidor con el MCP Inspector

Aquí viene la parte más útil para verificar que todo quede bien. Desde la terminal, confirmando primero que estás en la carpeta correcta, ejecutas mcp dev server.py [05:05]. El comando devuelve un token de sesión y un enlace al MCP Inspector, una herramienta fundamental mientras construyes tu propio servidor.

Si al presionar conectar te aparece un error de comunicación, hay una solución práctica. En lugar del comando por defecto, usas uno que antepone el inspector y cambia dev por run server.py. Con esa variante la conexión se establece de forma mucho más cómoda [06:30].

Una vez conectado, el inspector te deja escanear todos los componentes del servidor:

  • Al listar recursos directos, puede que no aparezca ninguno.
  • Al listar plantillas de recursos, encuentras el recurso greeting con el parámetro name.
  • Al listar herramientas, aparece el método para sumar dos números junto con su esquema.

Ese rastreo es clave: te muestra cómo están estructurados los componentes para que después un cliente pueda consumirlos. Lo rojo que aparece en pantalla al listar suele ser un log, no un error, así que no debe preocuparte.

¿Para qué sirve el MCP Inspector? Permite escanear tu servidor y ver sus recursos, prompts y herramientas, con el esquema de cada uno, para confirmar que están bien estructurados antes de conectar un cliente.

Qué practicar antes de crear el cliente

Antes de avanzar a la construcción del cliente, lo ideal es jugar un poco con tu servidor y ampliarlo.

Prueba a agregar métodos nuevos:

  • Herramientas para restar, multiplicar y dividir.
  • Un recurso que no solo diga "hola", sino que arme tu nombre completo con varios parámetros.

Experimentar con estas herramientas y recursos te deja listo para el siguiente paso, donde ya construiremos un cliente capaz de consumir todo lo que tu servidor expone. ¿Qué método te animas a agregar primero? Cuéntalo en los comentarios.