¿Qué es MCP Python SDK?
Model Context Protocol (MCP) es una forma estándar de conectar apps de IA con herramientas y datos. Este es el SDK oficial de Python para escribir servidores MCP (que exponen herramientas) y clientes (que las usan). También hay un SDK oficial de TypeScript, además de SDK para Go y C#.
La versión 2.0 salió el 28 de julio de 2026 junto con la revisión 2026-07-28 de la especificación. La clase FastMCP pasó a llamarse MCPServer, un único objeto Client sustituyó a la antigua estructura de sesiones por capas y se eliminó el transporte WebSocket. Los servidores siguen respondiendo a clientes antiguos.
La línea 1.x está en modo de mantenimiento, solo con correcciones de seguridad.
¿Merece la pena MCP Python SDK?
Esta es la implementación de referencia en Python de Model Context Protocol, y sigue la especificación antes que nadie. La versión 2.0 salió el 28 de julio de 2026 junto con la revisión 2026-07-28 de la especificación y sirve a la vez esa revisión y la 2025-11-25, así que un servidor v2 sigue respondiendo a clientes antiguos sin configurar nada. La última versión es la v2.3.0, del 2 de octubre de 2026.
El coste es la migración. FastMCP pasó a ser MCPServer, la ruta del módulo cambió, get_context() desapareció, los ajustes de transporte pasaron del constructor a run(), y el Server de bajo nivel se rehízo en torno a argumentos del constructor en lugar de decoradores. Las rutas antiguas se eliminaron en vez de marcarse como obsoletas. El transporte WebSocket, que nunca formó parte de la especificación, ya no está, igual que la API experimental Tasks. La línea 1.x sigue en mantenimiento con correcciones de seguridad, pero no hay fecha de fin publicada; fijar mcp>=1.28,<2 es la forma documentada de esperar.
El trabajo de seguridad ha sido intenso. El repositorio ha publicado 12 avisos, entre ellos un fallo de gravedad alta por el que las sesiones de Streamable HTTP nunca se liberaban por defecto (corregido en 1.30.0 y 2.2.0) y una comprobación de bearer tokens que aceptaba tokens emitidos para otro servidor de recursos. Quien tenga un servidor HTTP en 2.0 o 2.1 debe actualizar.
El proyecto independiente FastMCP, ahora en la v4.1.3 bajo PrefectHQ, tiene unas 28.200 estrellas frente a las 24.700 de este SDK y añade más comodidades por encima. El SDK oficial es la opción más ligera cuando importa más el comportamiento exacto de la especificación que los extras.
Dónde se gana su sitio
Un desarrollador de backend que expone una API interna sobre Postgres a Claude y otros clientes MCP
Publicar un servidor MCP que apruebe el equipo de seguridad
Escribir las herramientas como funciones decoradas en MCPServer, ejecutarlo sobre Streamable HTTP detrás de tu autenticación y quedarse en la 2.2.0 o posterior por las correcciones de liberación de sesiones y de audiencia de tokens. Un primer servidor son unas pocas decenas de líneas.
Un equipo de plataforma que mantiene diez servidores MCP v1
Planificar el paso a la v2 sin romper clientes
Fijar mcp>=1.28,<2 para seguir recibiendo correcciones de seguridad y después migrar un servidor cada vez con la lista de antes y después de la guía de migración. Como la v2 sirve las dos revisiones de la especificación, los clientes no tienen que cambiar al mismo tiempo.
Un responsable de ingeniería que elige una pila MCP en Python para un producto nuevo
Decidir entre el SDK oficial y FastMCP
El SDK oficial es MIT, lo mantiene el proyecto MCP y sigue primero la especificación; FastMCP añade más utilidades por encima. Los dos son gratuitos, así que la elección es entre fidelidad a la especificación y comodidad con más cambios en las actualizaciones.
Antes de decidirte
- Puesta en marcha
- uv add "mcp[cli]" o pip install "mcp[cli]" en Python 3.10+; uv run mcp run server.py --transport streamable-http arranca un servidor. Una herramienta decorada y una primera llamada llevan minutos.
- Integraciones
- Funciona con cualquier cliente MCP, incluidas las apps de Claude y los frameworks de agentes; incluye un Client para llamar a servidores por stdio o Streamable HTTP, y hay SDK hermanos en TypeScript, Go y C#. Los tipos del protocolo están en un paquete aparte, mcp-types.
- Datos y privacidad
- Es una biblioteca: por sí misma no envía nada a ninguna parte. Tu servidor ve todo lo que alcancen sus herramientas, así que la autenticación y el acotamiento son cosa tuya. 12 avisos publicados, entre ellos fuga de sesiones sobre Streamable HTTP y un cliente que descargaba URL $ref elegidas por el servidor durante la validación de esquemas.
- Coste a escala
- Gratuito bajo MIT. Alojar un servidor es alojamiento web normal de Python; las peticiones de la era 2026 no llevan sesión, lo que elimina el enrutamiento con sesiones persistentes del problema de alojamiento.
- Límites
- Unas 370 incidencias abiertas. En las conexiones de la era 2026 desaparecen las peticiones iniciadas por el servidor, así que ctx.elicit() falla y Resolve(...) lo sustituye; roots, sampling y el registro del protocolo están obsoletos, y ping se ha eliminado.
Lo bueno
- El primero en implementar las nuevas revisiones de la especificación
- Los servidores v2 responden a clientes 2026-07-28 y 2025-11-25
- Decoradores para herramientas, recursos y prompts en MCPServer
- Transportes stdio, Streamable HTTP y SSE
Lo malo
- La v2 eliminó sin más las rutas de import de la v1
- Se retiraron el transporte WebSocket y la API Tasks
- 12 avisos de seguridad; 2.0 y 2.1 necesitan actualización
- Menos extras que FastMCP independiente
Ideal para
Desarrolladores de Python que crean servidores o clientes MCP y quieren la implementación oficial, la que sigue la especificación.
Alternativas a MCP Python SDK
MCP Python SDK: preguntas frecuentes
- ¿Merece la pena MCP Python SDK?
- La forma de construir MCP en Python que sigue primero a la especificación; la versión 2 es más limpia, y por el camino rompe todos los imports de la v1. Le damos un 4.4 sobre 5.
- ¿Cuánto cuesta MCP Python SDK?
- Gratuito y de código abierto bajo licencia MIT.
- ¿Qué inconvenientes tiene MCP Python SDK?
- La v2 eliminó sin más las rutas de import de la v1; se retiraron el transporte WebSocket y la API Tasks; 12 avisos de seguridad; 2.0 y 2.1 necesitan actualización; menos extras que FastMCP independiente.
- ¿Para quién es MCP Python SDK?
- Desarrolladores de Python que crean servidores o clientes MCP y quieren la implementación oficial, la que sigue la especificación.
- ¿Cuánto cuesta MCP Python SDK para un equipo o en producción?
- Gratuito bajo MIT. Alojar un servidor es alojamiento web normal de Python; las peticiones de la era 2026 no llevan sesión, lo que elimina el enrutamiento con sesiones persistentes del problema de alojamiento.
- ¿Es MCP Python SDK seguro para los datos de la empresa?
- Es una biblioteca: por sí misma no envía nada a ninguna parte. Tu servidor ve todo lo que alcancen sus herramientas, así que la autenticación y el acotamiento son cosa tuya. 12 avisos publicados, entre ellos fuga de sesiones sobre Streamable HTTP y un cliente que descargaba URL $ref elegidas por el servidor durante la validación de esquemas.
- ¿Cuáles son las mejores alternativas a MCP Python SDK?
- Las alternativas más cercanas que hemos analizado son OpenAI Agents SDK y Pydantic AI.
Respuestas comprobadas el 23 oct 2026.