Repolode
modelcontextprotocol

modelcontextprotocol/python-sdk

SDK oficial de Python para crear servidores y clientes de Model Context Protocol que conectan aplicaciones con LLM con herramientas, datos y prompts.

Estrellas
24,624
Forks
4,275
Issues abiertos
361
Último commit
hace 3 días

¿Qué es?

El SDK de MCP para Python es la implementación oficial en Python de Model Context Protocol, un estándar abierto para exponer datos y funcionalidades a aplicaciones con LLM de forma segura y estandarizada. Permite a los desarrolladores crear servidores MCP que exponen herramientas, recursos y prompts a cualquier host MCP, y clientes MCP que se conectan a cualquier servidor MCP.

Los servidores se definen con funciones de Python convencionales con anotaciones de tipo y docstrings. Las anotaciones de tipo se convierten en el esquema de entrada, así que los desarrolladores no tienen que escribir JSON Schema, gestionar el análisis de solicitudes ni implementar el protocolo manualmente. El paquete incluye una herramienta de línea de comandos `mcp` para ejecutar servidores y abrirlos en MCP Inspector.

El SDK admite los transportes stdio, Streamable HTTP y SSE. Requiere Python 3.11 o posterior y se distribuye con licencia MIT.

Funciones clave

  • 01Crear servidores MCP que exponen herramientas, recursos y prompts mediante funciones de Python con anotaciones de tipo.
  • 02Crear clientes MCP que se conectan a servidores locales mediante stdio o a servidores remotos mediante Streamable HTTP.
  • 03Admite los transportes stdio, Streamable HTTP y SSE.
  • 04Incluye una CLI `mcp` para ejecutar servidores e iniciar MCP Inspector.

Casos de uso

  • Exponer APIs internas o bases de datos a un asistente con LLM como herramientas MCP.
  • Escribir un cliente de Python que invoque herramientas en un servidor MCP existente.
  • Crear prototipos y depurar servidores MCP con MCP Inspector.

Inicio rápido

  1. 1

    Instala el SDK con el extra CLI usando uv

    uv add "mcp[cli]"
  2. 2

    O instálalo con pip

    pip install "mcp[cli]"
  3. 3

    Crea server.py con una herramienta y un recurso (consulta el ejemplo del README)

  4. 4

    Ejecuta el servidor en MCP Inspector

    uv run mcp dev server.py

Antes de usarlo

  • Requiere Python 3.11 o posterior.
  • La documentación del README cubre una API v2, por lo que los tutoriales y ejemplos anteriores pueden no coincidir.

Temas

Preguntas frecuentes

¿Qué es python-sdk?
SDK oficial de Python para crear servidores y clientes de Model Context Protocol que conectan aplicaciones con LLM con herramientas, datos y prompts. El SDK de MCP para Python es la implementación oficial en Python de Model Context Protocol, un estándar abierto para exponer datos y funcionalidades a aplicaciones con LLM de forma segura y estandarizada. Permite a los desarrolladores crear servidores MCP que exponen herramientas, recursos y prompts a cualquier host MCP, y clientes MCP que se conectan a cualquier servidor MCP.
¿python-sdk es gratuito? ¿Qué licencia tiene?
python-sdk es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿python-sdk sigue mantenido?
Mantenimiento activo. El último commit de python-sdk fue el 17 oct 2026.
¿Para qué puedo usar python-sdk?
Exponer APIs internas o bases de datos a un asistente con LLM como herramientas MCP. Escribir un cliente de Python que invoque herramientas en un servidor MCP existente. Crear prototipos y depurar servidores MCP con MCP Inspector.
¿Cómo se instala python-sdk?
Instala el SDK con el extra CLI usando uv: uv add "mcp[cli]" O instálalo con pip: pip install "mcp[cli]" Crea server.py con una herramienta y un recurso (consulta el ejemplo del README) Ejecuta el servidor en MCP Inspector: uv run mcp dev server.py
¿Dónde consigo python-sdk?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/modelcontextprotocol/python-sdk

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados