KeelFramework

Keel Framework / Keel Framework/MCP / Java

Java 25 · Spring Boot 4 · Spring AI · MCP

Keel/MCP Java

Arquitectura de referencia para construir servidores MCP/Java.

Keel es la quilla sobre la que construyes tu servidor MCP: módulos técnicos reutilizables, convenciones claras y un Maven Archetype que genera el proyecto listo para desarrollar Tools, Resources y Prompts.

Empezar en cinco minutos Ver en GitHub
mcp-architecture-framework Parent / BOM

Common

  • common-jwt
  • common-exceptions

Adapters

  • adapter-auth-idp
  • adapter-cache-caffeine
  • adapter-rest-client

Transport

  • transport-auth-service
  • transport-session-service
  • transport-streamable-service
  • transport-cors-service

Observability

  • observability-logging
Maven Archetype <proyecto>-boot · -mcp · -model

Dos modos de trabajar con Keel/MCP Java

Elige según cuánto necesites adaptar la arquitectura. En los dos casos el resultado es un MCP Server que sigue las convenciones de Keel.

Modo 1 · Recomendado

Generar el scaffolding estándar

El Installer JAR crea un MCP Server con todos los módulos de la arquitectura Keel ya integrados: boot, mcp, model, configuración YAML y ficheros de despliegue. No necesitas clonar ni compilar el framework.

$ java -jar keel-mcp-archetype-installer.jar name-project version domain groupId
$ java -jar keel-mcp-archetype-installer-1.0.0.jar mcp-petstore-sample 1.0.0 petstore io.keelframework.sample
Empezar en cinco minutos Descargar el installer

Modo 2 · Para arquitectos

Adecuar la arquitectura Keel/MCP a tu modo de uso

Clona el framework, estudia los módulos common-*, adapter-*, transport-* y observability-*, y adapta o extiende la arquitectura base a tu modelo antes de generar el scaffolding.



$ git clone https://github.com/Keel-Framework/keel-mcp-java.git
Guía para adaptar la arquitectura Arquitectura en GitHub

De cero a servidor MCP

  1. Genera el scaffolding

    El Installer JAR crea el proyecto con los módulos boot, mcp y model, la configuración YAML y el pipeline de despliegue.

    Quickstart

  2. Compila y arranca

    mvn clean install y mvn spring-boot:run. El endpoint MCP queda disponible en /mcp con autenticación, sesión y observabilidad ya configuradas.

    Ejecutar el servidor

  3. Desarrolla tus capacidades

    Implementa Tools, Resources y Prompts con las anotaciones de Spring AI siguiendo las convenciones de Keel. Lo transversal ya está resuelto.

    Guía de desarrollo

Lo que Keel resuelve por ti

Autenticación y seguridad

Validación de JWT contra un proveedor OIDC (Keycloak / Red Hat SSO) con JWKS e introspección.

Gestión de sesión MCP

Ciclo de vida completo del Mcp-Session-Id: creación, validación y expiración.

Transporte Streamable HTTP

Endpoint de comunicación con los hosts MCP según la especificación del protocolo.

CORS

Configuración lista para clientes MCP basados en navegador.

Caché local

Caffeine con TTL y tamaño máximo, alineada con el estado de sesión del protocolo.

Cliente REST

Cliente HTTP preconfigurado (TLS, timeouts, pool) para invocar backends desde las Tools.

Observabilidad

Logs JSON estructurados con eventos técnicos, funcionales y de seguridad.

Gestión de versiones

Un Maven BOM centraliza dependencias, plugins y compatibilidad de todo el stack.

Construido con su propia arquitectura


Keel MCP — Implementación de Referencia Referencia viva

Keel MCP — Implementación de Referencia proporciona una implementación técnica completa de la Arquitectura Keel MCP, diseñada como referencia para developers y arquitectos que construyen servidores MCP con Spring AI. Este repositorio materializa los principios arquitectónicos, capas, componentes y convenciones definidos por Keel MCP en una implementación funcional.

  • Tools
  • Prompts
  • Resources
  • Autenticación JWT
  • Backends de demo sin configuración