MCP Server - RA1: Gestión de Ficheros DAM

Esqueleto educativo para el Resultado de Aprendizaje 1 del módulo “Acceso a Datos”
CFGS Desarrollo de Aplicaciones Multiplataforma (DAM)

📋 Descripción del Proyecto

Este proyecto es un servidor MCP (Model Context Protocol) educativo diseñado para que los estudiantes implementen el RA1: Desarrolla aplicaciones que gestionan información almacenada en ficheros.

¿Qué es MCP?

MCP es un protocolo que permite a las aplicaciones de IA interactuar con herramientas externas. En este caso, los estudiantes crearán herramientas que permiten a una IA gestionar archivos de usuarios en diferentes formatos.

🎯 Objetivos de Aprendizaje (RA1)

Al completar este proyecto, demostrarás:

• CE1.a: Análisis de clases relacionadas con el tratamiento de ficheros
• CE1.b: Utilización de flujos para el acceso a información en ficheros
• CE1.c: Utilización de clases para gestión de ficheros y directorios
• CE1.d: Escritura y lectura de información en formato XML
• CE1.e: Escritura y lectura de información en formato JSON
• CE1.f: Escritura y lectura de información en otros formatos estándar (CSV)

🏗️ Estructura del Proyecto

src/
├── main/java/com/dam/accesodatos/
│   ├── McpAccesoDatosApplication.java     # Aplicación principal
│   ├── model/
│   │   ├── User.java                      # ✅ Modelo de datos (COMPLETO)
│   │   ├── UserCreateDto.java             # ✅ DTO para creación (COMPLETO)
│   │   └── UserQueryDto.java              # ✅ DTO para consultas (COMPLETO)
│   └── ra1/
│       ├── FileUserService.java           # ✅ Interfaz con herramientas MCP (COMPLETO)
│       └── FileUserServiceImpl.java       # ❌ PARA IMPLEMENTAR POR ESTUDIANTES
└── test/
    ├── java/com/dam/accesodatos/ra1/
    │   └── FileUserServiceTest.java        # ✅ Tests TDD (COMPLETOS)
    └── resources/examples/
        ├── sample_users.csv                # ✅ Ejemplo CSV
        ├── sample_users.json               # ✅ Ejemplo JSON
        └── sample_users.xml                # ✅ Ejemplo XML

🚀 Cómo Empezar

1. Prerrequisitos

• Java 17+
• IntelliJ IDEA (con Gradle integrado)

2. Clonar e Importar en IntelliJ

git clone https://github.com/balejosg/mcp-file-management-ra1
cd mcp-server-ra1-ficheros

En IntelliJ IDEA:

1. File → Open → Seleccionar la carpeta del proyecto
2. IntelliJ detectará automáticamente build.gradle y configurará el proyecto
3. Esperar a que Gradle sincronice las dependencias

3. Compilar el Proyecto

Opción A - Desde IntelliJ:

• Build → Build Project (Ctrl+F9)

Opción B - Desde terminal:

gradle clean compileJava

4. Ejecutar Tests (Fallarán inicialmente)

Opción A - Desde IntelliJ:

• Botón derecho en src/test/java → Run 'All Tests'
• O usar panel Gradle: Tasks → verification → test

Opción B - Desde terminal:

gradle test