Ir al contenido

Servidores MCP nativos

Orionis declara herramientas, recursos y prompts como clases Python y compila su contrato una vez para HTTP, STDIO y pruebas. La versión del protocolo MCP admitida es 2026-07-28, único valor de SUPPORTED_VERSIONS; verifica esa compatibilidad con el cliente que conectarás.

MCP (Model Context Protocol) permite que clientes compatibles descubran e invoquen herramientas de tu aplicación, lean recursos declarados y obtengan prompts reutilizables. Orionis proporciona el servidor; tus servicios de negocio realizan el trabajo y controlan el acceso. Empieza con una herramienta de solo lectura, comprueba su resultado local y elige HTTP para un cliente remoto o STDIO para integrar un proceso local.

  1. Tu primer servidor y herramientas tipadas.
  2. Recursos, plantillas URI y prompts.
  3. Contenido, serialización y metadata.
  4. HTTP, STDIO y configuración.
  5. Progreso, continuación, suscripciones y extensiones.

Requiere Python 3.14+, schemas/msgspec para contratos tipados y una aplicación inicializada para registro de transportes. Los ejemplos con compile_server y McpTestClient(Container(), ServerClass) funcionan sin servidor ni datos externos. La expansión RFC 6570 utiliza la dependencia declarada uritemplate; publicar recursos no otorga acceso implícito al filesystem.

El contexto de cada llamada es independiente. Ninguna anotación descriptiva de una herramienta sustituye autenticación/autorización. Los endpoints web usan el kernel HTTP y los handlers usan el contenedor.