mcp-hibernate

Servidor MCP con Hibernate/JPA para RA3 - Acceso a Datos mediante ORM

Proyecto educativo de Spring Boot que demuestra el uso de Hibernate/JPA como ORM (Object-Relational Mapping) para estudiantes de DAM (Desarrollo de Aplicaciones Multiplataforma). Este proyecto implementa un servidor MCP (Model Context Protocol) que expone operaciones de persistencia de datos utilizando Hibernate.

Tabla de Contenidos

• Características Principales
• Requisitos Previos
• Instalación Rápida
• Estructura del Proyecto
• Cómo Ejecutar
• Herramientas MCP Disponibles
• Stack Tecnológico
• Metodología de Aprendizaje
• Documentación Complementaria
• Próximos Pasos

Características Principales

• Servidor MCP que expone operaciones Hibernate/JPA como herramientas para LLMs
• Hibernate/JPA como implementación ORM para mapeo objeto-relacional
• Spring Boot 3.3.0 con Java 21
• Base de datos H2 en memoria (modo PostgreSQL)
• 6 métodos implementados como ejemplos de estudio
• 4 métodos TODO para que los estudiantes implementen
• Suite de tests completa con JUnit 5 y Spring Boot Test
• Documentación pedagógica en español

Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

• Java 21 o superior (Descargar OpenJDK)
• Gradle 8.x (wrapper incluido en el proyecto)
• Git para clonar el repositorio
• Editor/IDE: IntelliJ IDEA, VS Code, o Eclipse
• Opcional: Postman o curl para probar endpoints

Instalación Rápida

# 1. Clonar el repositorio
git clone https://github.com/balejosg/mcp-hibernate.git
cd mcp-hibernate

# 2. Verificar versión de Java
java -version  # Debe ser Java 21+

# 3. Compilar el proyecto
./gradlew clean build

# 4. Ejecutar la aplicación
./gradlew bootRun

# 5. Verificar que el servidor está corriendo
curl http://localhost:8083/mcp/health

Para instrucciones detalladas de instalación y configuración de IDEs, consulta docs/GUIA_INSTALACION.md.

Estructura del Proyecto

mcp-hibernate/
├── src/main/java/com/dam/accesodatos/
│   ├── McpAccesoDatosRa3Application.java  # Aplicación principal
│   ├── model/                              # Entidades JPA y DTOs
│   │   ├── User.java                       # Entidad @Entity mapeada a tabla users
│   │   ├── UserCreateDto.java              # DTO para crear usuarios
│   │   ├── UserUpdateDto.java              # DTO para actualizar usuarios
│   │   └── UserQueryDto.java               # DTO para búsquedas con filtros
│   ├── ra3/                                # Servicios Hibernate/JPA (RA3)
│   │   ├── HibernateUserService.java       # Interface con @Tool annotations