¿Cuál es la mejor forma de instalar uv? El curso no lo menciona, ni siquiera en los recursos da una recomendación
Recursos
Resumen
Crear un servidor MCP con UV te permite trabajar en un entorno virtual aislado de Python, donde puedes experimentar, instalar paquetes y destruir todo sin afectar tu sistema. Si estás empezando con el Model Context Protocol y quieres una base ordenada para tu proyecto, aquí verás cómo armarlo paso a paso y cuáles son los cuatro elementos que componen un servidor MCP.
Por qué conviene usar un entorno virtual con UV en Python
Todo arranca con una carpeta limpia. En este caso, una carpeta llamada clase cuatro, sin el server.py ni las carpetas de compilación que suelen aparecer cuando trabajas con paquetes directamente.
La diferencia respecto a instalar con PIP de forma aislada es el aislamiento. UV es un manejador de ambientes virtuales dentro de Python que crea un espacio contenido donde todo lo que hagas puede desaparecer sin consecuencias [00:52].
¿Qué es UV en Python? Es un manejador de ambientes virtuales que inicializa proyectos de forma automatizada. Con un solo comando crea la estructura base y aísla las dependencias, así puedes eliminar la carpeta y empezar de cero sin problemas.
Y aquí viene lo interesante: esa capacidad de destruir todo saliéndote de UV o borrando la carpeta te da libertad para probar sin miedo a romper nada.
Cómo inicializar un proyecto MCP con el comando init
Desde la terminal, ubicado dentro de la carpeta del curso, te mueves con cd clase cuatro y ejecutas el comando de inicialización.
Los pasos concretos son:
- Escribir
uv init demo-mcp-serveren minúsculas, según las convenciones de UV. - Presionar enter para que arranque el proyecto automáticamente.
- Verificar con
lsque se creó la carpeta del servidor.
Al entrar con cd demo-mcp-server y volver a listar, aparecen tres archivos generados de forma automática: un README, un main.py y un pyproject.toml [01:40]. El nombre lleva mcp a propósito, para recordar que estás trabajando con el Model Context Protocol.
Ese mismo resultado lo puedes ver reflejado en Visual Studio, con la configuración de tu nuevo proyecto ya lista.
Cómo instalar la línea de comandos de MCP con UV add
Una vez dentro del nuevo entorno, instalas las dependencias de MCP con un comando distinto al de la clase pasada.
Escribes uv add "mcp[cli]", lo mismo que antes se hacía con PIP, y esperas unos segundos a que el entorno cargue e instale lo necesario para la línea de comandos de MCP [02:30].
¿Por qué mi servidor MCP no muestra nada en la terminal? Porque un servidor MCP no da retroalimentación directa a la terminal cuando se ejecuta. Al correr
uv run mcpno verás mensajes de estado, por eso necesitas el inspector para confirmar que funciona.
Esto pasa en los dos escenarios: ya sea dentro de UV o de forma aislada como en la clase anterior. Si ejecutas uv run mcp no sucede nada visible, e incluso puedes interrumpir el proceso con control C. Para saber que todo se maneja de forma adecuada, usas el inspector.
Cuáles son los cuatro elementos que componen un servidor MCP
Lo importante es que ambos enfoques, el aislado y el del entorno virtual, llevan exactamente al mismo código. Puedes crear un server.py dentro de tu nuevo entorno y pegar todo lo que ya tenías de la clase tres para obtener el mismo resultado [03:20].
Al explorar las opciones disponibles aparecen más piezas de las que trabajamos antes. Además de las tools, existen los resource y también la opción de escribir un @mcp.prompt.
¿Qué es un prompt en un servidor MCP? Es una forma en que el servidor guarda prompts previamente alistados para que el cliente los utilice. Permite tener instrucciones listas y reutilizables sin escribirlas desde cero cada vez.
Con todo esto sobre la mesa, la estructura de un MCP queda cubierta por cuatro elementos:
- La configuración del servidor, donde defines cosas como el puerto de comunicación. Por ahora
FastMCPy demo son suficientes. - La creación de herramientas o tools, que pueden verse distintas en tu código si dedicaste tiempo a crear varios métodos.
- La creación de recursos o resource, para manejar parámetros y ejecutar una función avanzada.
- La creación de prompts, con los prompts previamente alistados.
Ten presente que el main.py que se genera probablemente ni lo necesites, mientras que dentro de server.py sí tendrías que apuntar al archivo correcto. Con estos tres elementos de funcionalidad unificados en un servidor, ya tienes todo listo para que un cliente los consuma.
¿Ya probaste inicializar tu propio proyecto con UV? Cuéntame en los comentarios cómo te fue con la instalación de la línea de comandos.
