Configuración de entorno de trabajo para desarrollo MCP

Clase 4 de 22 • Curso de MCP con Microsoft Azure

Resumen

Al iniciar en el desarrollo con MCP, es clave entender cómo preparar un entorno de trabajo funcional y adaptable. Este proceso no tiene que ser complicado y permite elegir entre diferentes herramientas según tus preferencias. Aquí, te mostramos cómo hacerlo paso a paso usando Python y Visual Studio Code (VSCode), aunque también existen opciones alternativas para distintos entornos y lenguajes.

¿Qué opciones existen para configurar un entorno de trabajo MCP?

Puedes trabajar con VSCode, Eclipse, IntelliJ, Visual Studio o incluso soluciones en la nube como Cloud de Anthropic. Todas estas opciones son válidas, y la decisión dependerá de lo que más te acomode. Es importante destacar que aunque el ejemplo se realiza en * Python, existen SDKs para otros lenguajes: TypeScript, C sharp, Java y Node*. Esto brinda gran flexibilidad para adaptar MCP a tus necesidades.

¿Cómo instalar y preparar MCP usando Python?

El primer paso práctico es preparar un repositorio vacío. Dentro de él:

Crear un nuevo directorio usando mkdir clase_tres.
Acceder a este directorio y limpiar la terminal.
Instalar el paquete de pip para MCP ejecutando:
bash pip install mcp-cli Esto proporciona una herramienta de línea de comandos que ayuda a gestionar todos tus proyectos MCP.

Una vez instalado, abre el directorio en VSCode usando:

code .

Crea un archivo server.py. Opcionalmente puedes crear un entorno virtual de Python, pero para comenzar, trabajar directamente te permite avanzar rápido.

¿Cuál es el flujo básico para correr un servidor MCP?

En server.py debe incluirse un import de la librería MCP y la creación de un servidor, por ejemplo:

import fastmcp
mcpfastdemo = fastmcp.Server()

Puedes agregar recursos y herramientas personalizadas. Luego, desde la terminal, ejecuta:

mcp dev server.py

Verás que el servidor responde mostrando un token de sesión y la entrada al MCP Inspector. Si al intentar conectar en el inspector surge algún problema de conectividad, detén con control+C, limpia la terminal y ejecuta:

mcp run server.py

Esto suele solucionar cualquier inconveniente de conexión.

¿Cómo usar el MCP Inspector para revisar recursos y herramientas?

El Inspector permite listar recursos y herramientas del servidor. Puedes ver: - Recursos definidos, como greeting con el parámetro name. - Herramientas, como sumar dos números, accesibles desde el inspector.

El Inspector facilita rastrear todos los componentes, visualizar su estructura y chequear desde la interfaz lo que un cliente podría consumir. Utiliza la función de listar recursos y herramientas para validar la implementación.

¿Qué ejercicios prácticos ayudan a reforzar el aprendizaje?

Para mejorar la experiencia: - Agrega métodos como restar, multiplicar y dividir a tu servidor. - Crea recursos que permitan respuestas más personalizadas, por ejemplo: «Tu nombre completo es...», usando parámetros. - Experimenta con combinaciones de herramientas y recursos para ampliar las funcionalidades de tu servidor MCP.

¿Tienes ideas o dudas respecto a la configuración o uso de MCP? Comparte abajo tu experiencia y enriquece la conversación con nuevas propuestas y experimentos.

Miguel Angel de la Rosa Manríquez

student•

les paso el dato de lo que me funcionó a mi:npm install -g @modelcontextprotocol/server-everything

npm install -g @modelcontextprotocol/server-everything

instale la paquetería de forma global y de ahí me funcionó mcp dev server.py

John J. Meza

student•

funcionó perfecto para wsl2 en Windows, muchas gracias

Carlos Ruiz Bustillo

student•

Tengo este error de conexión, estuve probando primero con windows (usando git bash), pero luego probe con wsl, pero el error persiste :(

Carlos Enrique Ramírez Flores

student•

checa la documentación: https://modelcontextprotocol.io/docs/tools/inspector

y no veo que tienes un token en la url, por lo tanto creo que no ejecutaste tu inspector con npx @modelcontextprotocol/inspector

Diego Bassi

student•

Agrega el comando de inicio del server en Arguments, run server.py (si tu archivo se llama diferente modifica el nombre)

Fredy Flores

student•

Hola, para los que tienen Mac y les da error al intentar conectar el inspector, deben colocar el campo command y arguments de la siguiente forma:

Amin Espinoza

teacher•

No vi este comentario! Está buenísmo! De hecho hasta a mi me sirvió!

Alfredo Olmedo

student•

Quien tenga en windows WSL Windows Subsystem for Linux, con pyhton 3.12 es importante que sepan que el instalar pip de forma "pip install paquete" no es viable debido a que no se puede instalar un paquete de Python Gloabalmente. Es importante que creen un entorno de ambiente como es VENV, Conda etc, y despues instalar el paquete "pip install "mcp[cli]", previamente activado el entorno virtual.

Iván López Hdez

student•

Eso no es del todo correcto, no necesitas tener crear ningún entorno de ambiente. Basta con instalar python en windows desde el repo oficial https://www.python.org/downloads/ y en la propia instalación te da la opción de instalar pip, para que puedas usarlo de manera global en tu terminal. Luego vas al terminar y lanzas el comando pip install <paquete>

Angel Almazan

student•

Con Pipx funciona para instalaciones globales como con poetry

Fernado Michael Acosta Panchez

student•

para quienes tienen problema en la conexión el archivo python server.py debe tener esto: if __name__ == "__main__": mcp.run()

Luis Rodolfo Altuve Cáceres

student•

Excelente!

me funciono, por ende, no es necesario usar npx.

Hugo Rodriguez

student•

resumen, pésima clase 😡

1: código incompleto: agreguen esto a su file server.py

if __name__ == '__main__':

mcp.run()

2: necesitan instalar node:

lo pueden hacer desde aqui: https://nodejs.org/en/download

Amin Espinoza

teacher•

¿Por qué necesito iniciar el proyecto con un constructor si la aplicación está siendo ejecutada sin ningún problema?

William Schnaider Torres Bermon

student•

Code base:

# server.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server
mcp = FastMCP("Demo")


# Add an addition tool
@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b


# Add a dynamic greeting resource
@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

# Main execution block - this is required to run the server
if __name__ == "__main__":
    mcp.run()

Microsoft guide: https://github.com/microsoft/mcp-for-beginners/blob/main/03-GettingStarted/01-first-server/README.md

Cristian Pisco Intriago

student•

Hola aquí les dejo una imagen de como tengo configurado el MCP

Favio Náquira

student•

gracias, esto me funcionó en mac

Lilí Primaveral

student•

Para configurar un servidor MCP en Node.js, puedes utilizar el siguiente código como punto de partida:

const { MCP } = require('mcp');

const server = new MCP.Server('fast demo');

server.route('/sum', (req, res) => {
  const { a, b } = req.body;
  res.send({ result: a + b });
});

server.start(3000, () => {
  console.log('Servidor MCP en funcionamiento en http://localhost:3000');
});

Asegúrate de tener el paquete MCP instalado en tu proyecto. Puedes hacerlo usando npm install mcp. Luego, ejecuta el archivo para iniciar tu servidor.

Amin Espinoza

teacher•

¿Y si lo subes como aporte al repo de Github? Sería genial tener diferentes lenguajes!

andres reyes

student•

Genial @Amin que uno pueda contribuir al repo :)

Luis Muniz

student•

Mi experiencia es que si trabajas con Windows en WSL Ubuntu 22.04 deberas tomar en cuenta lo siguiente:

Si tu carpeta de proyecto está en la ruta /mnt/c/Users/... cuando se invoca npm o npx o node se invocan los paquetes de windows y eso da problemas para el Inspector y no se puede conectar. Para solucionarlo esto es lo que hice:

1.- Crear tu carpeta de proyecto en /home/miusuario/CursoMCP/...

2.- Instalar python, pip y venv en el WSL y que no se tome el bridge de windows, como saberlo? con los siguientes comandos:

> which python3 # deberá mostrar /usr/bin/python3

> which node # deberá mostrar /usr/bin/node

> which npm # deberá mostrar /usr/bin/npm

Si muestra rutas que apuntan a las carpetas de windows , esta usando los bridges de WSL y deberas instalar correctamente con:

> sudo apt update && sudo apt upgrade

> sudo apt install -y curl gnupg python3-pip python3-venv

> sudo apt install -y nodejs

Una vez instalado todo, deberas crear en la carpeta de clase3 el venv

> python3 -m venv venv > source venv/bin/activate

con el venv activado instalar mcp[cli]

> pip install "mcp[cli]"

Y con esto deberan poder ejecutar el Inspector

> npx @modelcontextprotocol/inspector mcp run server.py

NOTA: Recuerden antes de presionar Connect, en los campos :

Transport Type -> STDIO
Command -> mcp
Argument -> run server.py

Sebastian Marin

student•

Muchisimas gracias por tomarte el tiempo de escribir todo tan detallado. Fue la unica respuesta que me funciono.

Sergio Brandon De Lucio Chavero

student•

Es impresionante que muchas herramientas que estan saliendo con respecto a la inovacion en AI, salen primero para linux, viva Arch Linux jajajaja

Amin Espinoza

teacher•

No, no, no, viva Ubuntu!!!!! Jajajajaja

Edgar A. Gonzalez Ambriz

student•

Profesor Amin, el resumen de ésta clase está incompleto

Amin Espinoza

teacher•

¿Qué le falta? Lo siento, apenas vi este mensaje.

Roberto Jacobo

student•

para los que les da error con el comando mcp dev server.py sólo en el input de command cambien de "uv" a "mcp" igual en arguments a run server.py

Victor Chavarro

student•

en mi caso me tocó actualizar a node 22.17.1 usando nvm e instalar @modelcontextprotocol/inspector globalmente

Lester Rodriguez

student•

servidor mcp no levanta, ya tiene instalado el paquete mcp-cli

pip install mcp-cli

Version de python pip --version pip 25.2 from --> Python\Python313\site-packages\pip (python 3.13)

Agustin Diaz

student•

Quien escribe el resumen de la clase? Como que MCP = Multimodal Cognitive Platform? No es Model Context Protocol?

Karen Paola Torres Archbold

student•

Si pero da a entender que existen otros MCP como: Message Control Protocol (MCP):

Destaca que es un protocolo de control y enrutamiento de mensajes entre usuario, cliente, servidor y host.
Tiene una estructura más “de red” o “middleware” que organiza la comunicación.

Model Context Protocol:

Que el protocolo organiza y gestiona el contexto que se pasa a un modelo de lenguaje.
Más orientado a sistemas que necesitan mantener coherencia y memoria entre preguntas y respuestas.

Multimodal Cognitive Platform:

Implica una plataforma (no solo un protocolo) que integra distintas modalidades (texto, voz, imagen, etc.) y capacidades cognitivas.
Sugeriría algo más complejo que solo un flujo cliente-servidor-host.

Iván López Hdez

student•

Si le preguntas a ChatGPT sobre MCP lo primero que te responde es que es un Modelo Cognitivo Predictivo (MCP)... ahi tienes tu respuesta de donde viene

Arturo Delgado

student•

Alguien tiene el mismo problema que yo?

Gagandeep Dass Kaur

student•

Hola Arturo, yo tube ese mismo problema y lo que hice fue configurar esto asi:

pero antes ejecuté npx @modelcontextprotocol/inspector mcp run server.py

"server.py" hace referencia a mi archivo que se llama asi

Tube que clicar 2-3 veces en "conectar".

Espero que esto te sirva

Arturo Delgado

student•

Gracias por tu tiempo bro! De hecho si vi esa misma sugerencia en otro post de Huggin Face pero ni así pude acceder correctamente al inspector, de igual forma te agradezco mucho.

Juan Sebastián Martinez Caldas

student••

Tip:

En windows y con uv, a mi me funcionó utilizando el siguiente comando:

npx @modelcontextprotocol/inspector uv run python server.py

con el comando: npx @modelcontextprotocol/inspector mcp run server.py

Obtenía errores al tratar de conectar el cliente.

Adicional, tuve que agregar esto al server.py

if __name__ == "__main__":

mcp.run()

Andres Silva Vega

student••

Para los dockerosos o que no quieren instalar nada en su SO anfitrión les dejo dockerfile y docker-compose que use para levantar el proyecto. El contenedor queda para escribir los comandos del curso. dockerfile:

FROM python:3.14-slim-bookworm 
RUN apt-get update && apt-get install -y curl
RUN curl -fsSL https://deb.nodesource.com/setup_22.x | bash - \
    && apt-get install -y nodejs \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*
ENV PYTHONUNBUFFERED=1
ENV PYTHONDONTWRITEBYTECODE=1
WORKDIR /app
COPY . .
RUN pip3 install -r requirements.txt
# con bash debe iniciar el contenedor con terminal interativa
CMD ["tail", "-f", "/dev/null"]

requirements.txt

uvicorn>=0.24.0
fastapi>=0.104.0
mcp[cli]>=1.0.0
uv

La verdad solo es necesario mcp[cli]

docker-compose.yml

services:
  mcp:
    build: .
    volumes:
      - ./app:/app
    environment:
      - MCP_SERVER_PORT=6274
      - HOST=0.0.0.0
    ports:
      - "6274:6274"
      - "6277:6277"

# Levantan el contenedor
docker compose up -d
# Entran al contenedor para entrar comandos
docker exec -it <nombre-contenedor> bash
# adentro del contenedor
npx @modelcontextprotocol/inspector mcp run clase3/server.py

Roberto Angulo

student•

No entendí. Claude tiene IDE?

Amin Espinoza

teacher•

Ve a jugar! Claude Code - AI Pair Programming Assistant | ClaudeCode.io

Roberto Angulo

student•

Bueno me refería más a algo similar a cursor. Claude code es solo por command line. Pensé que ya tenía una interfaz visual distinta a solo command line