Configuración de MCP

Este documento explica cómo configurar el entorno para utilizar el SDK de MCP y, opcionalmente, sus herramientas de línea de comando (CLI).

Prerequisite knowledge

This quickstart assumes you have familiarity with:

• Python
• LLMs like Claude

System requirements

• Python 3.10 or higher installed.
• You must use the Python MCP SDK 1.2.0 or higher.

Set up your environment First, let’s install uv and set up our Python project and environment:

curl -LsSf https://astral.sh/uv/install.sh | sh

Make sure to restart your terminal afterwards to ensure that the uv command gets picked up.

Create a new directory for our project

uv init mcp-server
cd mcp-server

Create virtual environment and activate it

uv venv
source .venv/bin/activate  # On Windows use: .venv\Scripts\activate

Install dependencies

uv add "mcp[cli]" httpx
uv add requests
uv add mcp

Opción 1: Probar con MCP Inspector (modo desarrollo)

Dado que instalamos el paquete con [cli], podemos ejecutar:

mcp dev server_demo1.py

Esto iniciará nuestro servidor Demo y abrirá una interfaz de desarrollo (generalmente en el navegador web) que nos permite ver qué recursos y herramientas expone el servidor, y llamarlos manualmente para verificar su funcionamiento​

En este modo, podemos probar, por ejemplo, llamar a add con ciertos valores y ver si devuelve la suma correcta, o solicitar greeting://Alice y ver si obtenemos "Hola, Alice!" como respuesta. Esta prueba nos asegura que el servidor funciona correctamente por sí solo.

Opción 2: Claude Desktop

Añadimos stdio

if __name__ == "__main__":
    mcp.run(transport='stdio')

run server

uv run server_demo1.py

mcp install server_demo2.py

uv add PyMuPDF

Opción 2: Client

uv run client_demo.py