⚡ REE MCP Server
    
Habla con la red eléctrica española a través de Claude - sin conocimientos técnicos
Pregunta a Claude sobre demanda, generación, precios y emisiones de electricidad en España usando lenguaje natural. Él se encarga de todos los detalles técnicos.
Construido con Domain-Driven Design y Clean Architecture por Javi Santos - Especialista en IA y Robótica con investigación publicada en visión por computador e interpretabilidad de LLMs.
💡 ¿Quieres aprender a construir proyectos así? Únete a La Escuela de IA - la comunidad donde aprenderás IA práctica, sin humo, con ejemplos reales en español.
🎯 ¿Qué Hace Este Servidor?
Red Eléctrica de España (REE) gestiona la red eléctrica española 24/7, publicando datos cada 5 minutos. Este servidor MCP hace esos datos accesibles mediante conversación natural con Claude.
El Poder de Conversaciones con Datos Reales
*Por Javi Santos*
En lugar de escribir scripts de Python, imagina conversaciones como esta:
Tú: *"Comprueba qué pasó el 28 de abril de 2025"*
Claude: *Analiza datos de la red...*
🚨 EVENTO CRÍTICO DETECTADO - 28 de Abril de 2025 a las 12:35h
Colapso Masivo de la Red:
- 11.000 MW perdidos en 5 minutos (caída del 43% de capacidad)
- El sistema cayó de 25.184 MW → 14.185 MW instantáneamente
- Compatible con escenario de apagón en cascada
- La recuperación tardó más de 10 horas
Análisis:
- 11:00-12:30: Sistema estable, sin avisos previos
- 12:30-12:35: Fallo catastrófico instantáneo
- 12:35-13:35: Degradación continua hasta mínimo de 9.635 MW
- Causa probable: Disparo de planta nuclear → colapso de frecuencia → cascada
*Este sería uno de los peores apagones de España en la historia moderna.*
Ese es el poder de este servidor. Investiga eventos en la red, analiza tendencias renovables vs fósiles, correlaciona precios con demanda, o sigue la descarbonización de España - todo mediante conversación natural.
Sin documentación de API. Sin scripts. Solo pregunta.
🚀 Instalación (3 minutos)
1️⃣ Clonar e Instalar
# Clonar el repositorio
git clone https://github.com/ESJavadex/ree-mcp.git
cd ree-mcp
# Instalar uv (gestor rápido de paquetes Python)
curl -LsSf https://astral.sh/uv/install.sh | sh
# O en macOS: brew install uv
# Crear entorno virtual e instalar
uv venv
source .venv/bin/activate # En Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"2️⃣ Configurar Token de API
# Copiar el archivo de ejemplo (incluye token demo)
cp .env.example .env
# Editar .env si necesitas tu propio token
# REE_API_TOKEN=tu_token_aquiObtener Token:
- Pruebas/Demo: Ya incluido en
.env.example - Producción: Email a consultasios@ree.es
3️⃣ Añadir a Claude Code
# Ejecutar el script de instalación
./INSTALL_COMMAND.sh
# Verificar
claude mcp listDeberías ver ree-mcp: ✓ Connected.
4️⃣ ¡Listo! Empieza a Preguntar
Abre Claude Code y prueba:
- *"Muéstrame la demanda eléctrica actual de España"*
- *"¿Cuál es el mix de generación ahora?"*
- *"Compara generación solar vs eólica hoy"*
💬 ¿Qué Puedes Preguntar?
📊 Operaciones en Tiempo Real
- *"¿Cuál es la demanda eléctrica de España ahora mismo?"*
- *"Muéstrame el mix de generación al mediodía"*
- *"¿Cuánta energía exportó España ayer?"*
- *"Compara la demanda de hoy con la semana pasada"*
- *"¿Qué está generando cada central ahora? (nuclear, eólica, solar...)"*
🔍 Investigación y Análisis de Eventos
- *"Investiga qué pasó el 28 de abril de 2025"*
- *"¿Hubo actividad inusual en la red el mes pasado?"*
- *"Encuentra el día de pico de demanda este año y explica por qué"*
- *"Analiza la correlación entre generación eólica y precios"*
- *"Detecta patrones anómalos en la última semana"*
- *"¿Cuándo fue la última vez que hubo un apagón o evento crítico?"*
🌱 Energías Renovables y Emisiones
- *"¿Cuánta energía solar está generando España?"*
- *"Compara generación renovable vs fósil esta semana"*
- *"¿Cuáles son las emisiones de CO₂ actuales? (gCO₂/kWh)"*
- *"Muéstrame la tendencia de energía eólica en los últimos 30 días"*
- *"¿Qué porcentaje de la demanda viene de renovables?"*
- *"¿Cuándo fue el día más limpio (menos CO₂) este mes?"*
💰 Análisis de Precios y Mercado
- *"¿Cuál es el precio SPOT de electricidad ahora?"*
- *"Encuentra las horas más baratas para consumir electricidad hoy"*
- *"Compara tarifas PVPC entre días laborables y fines de semana"*
- *"¿Cuándo fue la electricidad más cara este mes? ¿Por qué?"*
- *"Muéstrame la correlación entre precios y generación renovable"*
⚙️ Estabilidad de Red y Almacenamiento
- *"¿Cómo está la estabilidad de la red ahora? (inercia síncrona vs renovable variable)"*
- *"¿Se están usando las centrales de bombeo para almacenar energía?"*
- *"Muéstrame los flujos de importación/exportación con Francia y Portugal"*
- *"¿Cuándo bombea agua la red y cuándo la turbina?"*
🔎 Descubrimiento de Datos
- *"Busca todos los indicadores relacionados con 'nuclear'"*
- *"¿Qué datos hay disponibles sobre generación hidroeléctrica?"*
- *"Muéstrame todos los indicadores de precios"*
- *"Lista los indicadores disponibles de emisiones y sostenibilidad"*
📈 Comparativas y Tendencias
- *"Compara la demanda de este mes vs el mismo mes del año pasado"*
- *"¿Cómo ha evolucionado la generación solar en los últimos 6 meses?"*
- *"Muéstrame el balance neto de exportación/importación del último mes"*
- *"¿Cuándo alcanzamos el pico histórico de generación renovable?"*
Claude usa automáticamente las herramientas correctas, obtiene los datos y los presenta en contexto con análisis detallado.
🎓 Aprende a Construir Proyectos como Este
Este proyecto fue creado por Javi Santos, Especialista en IA y Robótica con investigación publicada en:
- 🔬 Detección de gasas quirúrgicas usando Redes Neuronales Convolucionales
- 🧠 Interpretabilidad de Modelos de Lenguaje en escenarios de conocimiento diverso
📚 La Escuela de IA
¿Quieres aprender IA sin humo y construir proyectos como este?
Únete a La Escuela de IA - la comunidad española de aprendizaje de IA donde encontrarás:
- 🎯 Práctica real - Construye proyectos reales de IA, no ejemplos de juguete
- 🇪🇸 Contenido en español - Por fin, educación en IA en tu idioma
- 🛠️ Recursos prácticos - Código, tutoriales y ejemplos hands-on
- 👥 Comunidad activa - Aprende con otros entusiastas de la IA hispanohablantes
📺 Canal de YouTube
Suscríbete a JavadexAI para:
- 🎥 Tutoriales de IA y recorridos de proyectos
- 💡 Aplicaciones de LLMs y servidores MCP
- 🚀 Estrategias de implementación de IA en el mundo real
🤝 Conecta
- LinkedIn: Javi Santos
- YouTube: @JavadexAI
- Escuela de IA: skool.com/la-escuela-de-ia-9955
🔥 Características Técnicas
✅ Listo para Producción
- Reintentos automáticos con backoff exponencial
- Manejo exhaustivo de errores y validación
- Async/await para rendimiento óptimo
- 96 tests exhaustivos con 90% cobertura
🏗️ Arquitectura Robusta
- Domain-Driven Design - Lógica de negocio pura
- Clean Architecture - Separación clara de responsabilidades
- Principios SOLID - Código mantenible y extensible
- Type Safety - 100% tipado con mypy modo estricto
📊 Datos Completos
- Acceso a 1.967+ indicadores de REE
- Datos cada 5 minutos en tiempo real
- Histórico completo disponible
- 14 herramientas MCP especializadas
🤝 Contribuir
¡Las contribuciones son bienvenidas! Ver CLAUDE.md para guía detallada de desarrolladores.
Este código sigue principios arquitectónicos estrictos:
- Domain-Driven Design
- Clean Architecture
- Principios SOLID
- Testing exhaustivo
💬 Soporte y Recursos
Problemas y Preguntas
- Problemas del Servidor: Abrir un issue
- Preguntas sobre API REE: consultasios@ree.es
Aprende Más
- 📚 La Escuela de IA - Aprende IA en español
- 📺 JavadexAI en YouTube
- 🤝 LinkedIn de Javi Santos
Recursos
- API eSios de REE: https://api.esios.ree.es/
- FastMCP: https://github.com/jlowin/fastmcp
- Model Context Protocol: https://modelcontextprotocol.io/
📄 Licencia
MIT License con Descargo de Responsabilidad - Ver archivo LICENSE para detalles completos.
⚠️ Proyecto Educativo: Este software se proporciona "tal cual" sin garantías. Úsalo bajo tu propio riesgo.
Construido con ❤️ usando Domain-Driven Design y mejores prácticas modernas de Python
⭐ ¡Dale una estrella al repo si te resulta útil!