mcp -ra2-jdbc

Este MCP server implementa un conjunto de 13 herramientas JDBC expuestas a través del protocolo MCP. El servidor se comunica con Claude Code (u otro cliente MCP compatible) vía un adaptador Python que traduce las llamadas MCP a peticiones HTTP REST hacia el backend Spring Boot que utiliza JDBC vanilla contra una base de datos H2 en memoria. Una vez conectado, tendrás acceso a herramientas para gestionar conexiones, operaciones CRUD, consultas avanzadas, transacciones, metadatos y funciones de agregación, todas diseñadas para aprendizaje práctico de JDBC sin abstracciones de nivel superior.

Para usarlo, primero inicia el adaptador MCP, que a su vez supervisa si el servidor Spring Boot está en ejecución y lo inicia si es necesario. Luego conéctate desde Claude Code utilizando el cliente MCP; Claude mostrará la lista de herramientas disponibles y te permitirá invocarlas enviando parámetros JSON. Cada herramienta mapea a una operación JDBC definida en las clases de implementación del proyecto RA2 (con 5 métodos ya implementados y 8 por completar, tal como se describe en el README original).

Prerequisitos:

• Java 17 o superior
• Gradle (wrapper incluido en el proyecto)
• Python 3.x (para el adaptador MCP)
• Una terminal o consola para ejecutar comandos

Instalación paso a paso:

1. Clonar el repositorio y navegar al proyecto:

   git clone <repositorio-del-proyecto> cd mcp-server-ra2-jdbc

2. Construir el proyecto Spring Boot y sus dependencias (JDK 17+ requerido):

   ./gradlew clean build

3. Preparar el adaptador MCP (Python):

   • Asegúrate de que Python 3 esté instalado.
   • Coloca el archivo mcp_adapter.py en una ruta accesible.
   • Actualiza el path absoluto en el script o utiliza la ruta indicada en tu configuración.

4. Ejecutar el adaptador MCP (Python) con el servidor RA2-JDBC:

   python3 /ruta/absoluta/mcp_adapter.py

5. Opcional: arrancar el servidor Spring Boot manualmente para ver la consola y la DB de ejemplo:

   ./gradlew bootRun

Notas:

• El adaptador iniciará ./gradlew bootRun si detecta que el servidor no está corriendo.
• Asegúrate de que el puerto 8082 está disponible para la app Spring Boot.

Consejos y notas útiles:

• El README del proyecto señala que el servidor arranca en http://localhost:8082; verifica que este puerto no esté ocupado en tu entorno.
• Las herramientas MCP están documentadas en el código, con una distribución entre ya implementadas (5) y pendientes (8) para completar por parte de los estudiantes.
• Configura correctamente el archivo de configuración MCP (.mcp.json) si vas a usar Claude Code; el adaptador Python se encarga de lanzar el servidor Spring Boot automáticamente y de realizar las conversiones entre MCP y REST de Spring Boot.
• Si el adaptador no inicia, revisa los permisos de ejecución, la ruta al script y las dependencias de Python. Revisa también la salida de la consola para errores de conexión a la base de datos H2 (memoria) o problemas de puerto.
• En entorno educativo, puedes modificar la configuración de H2 para usar un modo persistente si necesitas conservar datos entre ejecuciones durante prácticas.