Saltar a contenido

Instalación

Traducción automática

Esta página se tradujo automáticamente a partir de la documentación en inglés, y la página en inglés es la versión de referencia. Si algo no se lee bien, Traducciones explica cómo avisarnos.

El SDK de Python está en PyPI como mcp. Requiere Python 3.10+.

Esta documentación describe v2, la línea de versiones estable actual:

uv add "mcp[cli]"

pip install "mcp[cli]"

¿Vienes de v1?

v2 es una versión mayor con cambios incompatibles; la Guía de migración los cubre todos. Si tu paquete depende de mcp y aún no está listo para migrar, mantén un límite superior <2 (por ejemplo mcp>=1.28,<2) para que una resolución sin versión fijada se quede en la línea 1.x.

Qué se instala

No necesitas saber nada de esto para usar el SDK, pero si te preguntas para qué sirve cada dependencia:

  • mcp-types: todos los tipos del protocolo (solicitudes, resultados, bloques de contenido) como paquete propio, versionado a la par del SDK. El código que depende de mcp lo importa a través del alias mcp.types (cada from mcp.types import ... de esta documentación); importa mcp_types directamente solo en un proyecto que instale mcp-types sin el SDK.
  • anyio: el entorno de ejecución asíncrono. Todo el SDK está escrito sobre anyio, así que funciona tanto con asyncio como con trio.
  • pydantic: la base de todos los modelos de mcp.types, además de toda la generación y validación de esquemas.
  • httpx2: el cliente HTTP detrás de los transportes de cliente Streamable HTTP y SSE, con compatibilidad integrada con server-sent events.
  • starlette, uvicorn, sse-starlette y python-multipart: los transportes HTTP de servidor.
  • jsonschema: valida la salida estructurada de una herramienta contra su esquema de salida declarado.
  • pyjwt[crypto]: manejo de tokens OAuth para la autorización.
  • opentelemetry-api: solo la API ligera, de modo que el middleware de trazas del SDK no cuesta nada a menos que instales por tu cuenta un SDK y un exportador de OpenTelemetry.
  • typing-extensions y typing-inspection: funcionalidades modernas de tipado en Python 3.10.
  • pywin32: solo en Windows, se usa para la gestión de subprocesos stdio.

Extras opcionales

  • mcp[cli] añade typer y python-dotenv para la herramienta de línea de comandos mcp (mcp dev, mcp run, mcp install). La querrás durante el desarrollo; puede que no la necesites en un servidor desplegado.
  • mcp[rich] añade rich para unos logs del servidor más legibles.