Ree MCP

🚀 ⚡ REE MCP Server

本项目允许你通过Claude与西班牙电网进行交互，无需具备专业技术知识。你可以使用自然语言向Claude询问西班牙电力的需求、发电、价格和排放等信息，Claude会处理所有技术细节。

该项目由Javi Santos基于领域驱动设计和整洁架构构建。Javi Santos是人工智能和机器人领域的专家，在计算机视觉和大语言模型可解释性方面有相关研究成果发表。

💡 想学习如何构建此类项目？ 加入 La Escuela de IA ，这是一个西班牙语的人工智能学习社区，你可以在这里学习到实用的人工智能知识，并通过实际案例进行实践。

🚀 快速开始

项目功能

西班牙电网公司（Red Eléctrica de España, REE）全天候管理西班牙电网，并每5分钟发布一次数据。本MCP服务器借助自然语言与Claude交互，让这些数据易于获取。

与真实数据对话的力量

想象一下，无需编写Python脚本，只需进行如下对话： 你：“查看2025年4月28日发生了什么” Claude：分析电网数据...

🚨 重大事件检测 - 2025年4月28日12:35

电网大规模崩溃：

• 5分钟内损失11,000兆瓦（容量下降43%）
• 系统瞬间从25,184兆瓦降至14,185兆瓦
• 可能引发级联停电
• 恢复时间超过10小时

分析：

• 11:00 - 12:30：系统稳定，无预警
• 12:30 - 12:35：瞬间灾难性故障
• 12:35 - 13:35：持续恶化至最低9,635兆瓦
• 可能原因：核电站跳闸 → 频率崩溃 → 级联故障

这可能是西班牙现代历史上最严重的停电事件之一。

本服务器的强大之处在于，你可以通过自然语言调查电网事件、分析可再生能源与化石能源的趋势、关联价格与需求，或者跟踪西班牙的脱碳进程。无需API文档，无需编写脚本，只需提出问题。

✨ 主要特性

实时操作

• 实时查询西班牙的电力需求。
• 查看中午的发电组合。
• 了解西班牙昨日的能源出口量。
• 比较今日与上周的电力需求。
• 查询当前各发电站（核能、风能、太阳能等）的发电情况。

事件调查与分析

• 调查特定日期（如2025年4月28日）的电网事件。
• 查找上月电网的异常活动。
• 找出今年电力需求高峰日并分析原因。
• 分析风能发电与电价的相关性。
• 检测上周的异常模式。
• 查询上次停电或重大事件的时间。

可再生能源与排放

• 了解西班牙当前的太阳能发电量。
• 比较本周可再生能源与化石能源的发电量。
• 查询当前的二氧化碳排放量（克二氧化碳/千瓦时）。
• 查看过去30天风能发电的趋势。
• 了解可再生能源在电力需求中的占比。
• 找出本月二氧化碳排放最少的“清洁日”。

价格与市场分析

• 查询当前的电力现货价格。
• 找出今日用电最便宜的时段。
• 比较工作日和周末的PVPC电价。
• 找出本月电价最高的时间及原因。
• 查看电价与可再生能源发电的相关性。

电网稳定性与储能

• 评估当前电网的稳定性（同步惯性与可变可再生能源）。
• 了解抽水蓄能电站是否在储存能源。
• 查看与法国和葡萄牙的电力进出口流量。
• 查询电网抽水和发电的时间。

数据探索

• 查找所有与“核能”相关的指标。
• 了解有关水力发电的可用数据。
• 查看所有电价指标。
• 列出可用的排放和可持续性指标。

比较与趋势分析

• 比较本月与去年同月的电力需求。
• 查看过去6个月太阳能发电的发展趋势。
• 查看上月的净电力进出口平衡。
• 查询可再生能源发电的历史高峰时间。

Claude会自动使用正确的工具，获取数据并进行详细分析后呈现结果。

📦 安装指南

1️⃣ 克隆并安装

# 克隆仓库
git clone https://github.com/ESJavadex/ree-mcp.git
cd ree-mcp

# 安装uv（快速Python包管理器）
curl -LsSf https://astral.sh/uv/install.sh | sh
# 或者在macOS上：brew install uv

# 创建虚拟环境并安装依赖
uv venv
source .venv/bin/activate  # 在Windows上：.venv\Scripts\activate
uv pip install -e ".[dev]"

2️⃣ 配置API令牌

# 复制示例文件（包含演示令牌）
cp .env.example .env

# 如果你需要自己的令牌，请编辑.env文件
# REE_API_TOKEN=your_token_here

获取令牌：

• 测试/演示：.env.example 文件中已包含演示令牌。
• 生产环境：发送邮件至 consultasios@ree.es 获取。

3️⃣ 添加到Claude Code

# 运行安装脚本
./INSTALL_COMMAND.sh

# 验证安装
claude mcp list

你应该看到 ree-mcp: ✓ Connected。

4️⃣ 开始提问

打开Claude Code并尝试以下问题：

• “显示西班牙当前的电力需求”
• “当前的发电组合是什么？”
• “比较今日太阳能与风能的发电量”

💻 使用示例

基础用法

在Claude Code中输入以下自然语言问题：

"显示西班牙当前的电力需求"

高级用法

"分析过去一年中，西班牙可再生能源发电占比的变化趋势，并与同期的电价波动进行关联分析"

📚 详细文档

学习构建类似项目

本项目由**Javi Santos**创建，他是人工智能和机器人领域的专家，发表过以下研究：

• 🔬 使用卷积神经网络检测手术纱布
• 🧠 在不同知识场景下大语言模型的可解释性

📚 La Escuela de IA

你想脚踏实地学习人工智能并构建类似项目吗？加入**La Escuela de IA**，这是一个西班牙语的人工智能学习社区，你将获得：

• 🎯 真实实践：构建真实的人工智能项目，而非玩具示例。
• 🇪🇸 西班牙语内容：终于有了用你母语进行的人工智能教育。
• 🛠️ 实用资源：代码、教程和实践示例。
• 👥 活跃社区：与其他西班牙语人工智能爱好者一起学习。

👉 加入La Escuela de IA

📺 YouTube频道

订阅**JavadexAI**，获取：

• 🎥 人工智能教程和项目演示
• 💡 大语言模型和MCP服务器的应用
• 🚀 人工智能在现实世界中的实施策略

🤝 联系信息

• LinkedIn：Javi Santos
• YouTube：@JavadexAI
• La Escuela de IA：skool.com/la-escuela-de-ia-9955

🔧 技术细节

✅ 生产就绪

• 自动重试，采用指数退避策略
• 全面的错误处理和验证
• 异步/等待机制，实现最佳性能
• 96个全面测试，覆盖率达90%

🏗️ 稳健架构

• 领域驱动设计 - 纯粹的业务逻辑
• 整洁架构 - 明确的职责分离
• SOLID原则 - 可维护和可扩展的代码
• 类型安全 - 使用mypy严格模式进行100%类型检查

📊 完整数据

• 访问REE的1,967+个指标
• 每5分钟实时数据
• 完整的历史数据
• 14个专业MCP工具

🤝 贡献

欢迎贡献代码！请查看 CLAUDE.md 获取详细的开发者指南。本代码遵循严格的架构原则：

• 领域驱动设计
• 整洁架构
• SOLID原则
• 全面测试

💬 支持与资源

问题与咨询

• 服务器问题：提交一个issue
• REE API咨询：consultasios@ree.es

学习更多

• 📚 La Escuela de IA - 用西班牙语学习人工智能
• 📺 YouTube上的JavadexAI
• 🤝 Javi Santos的LinkedIn

资源

• REE的eSios API：https://api.esios.ree.es/
• FastMCP：https://github.com/jlowin/fastmcp
• 模型上下文协议：https://modelcontextprotocol.io/

📄 许可证

MIT许可，免责声明 - 详情请查看 LICENSE 文件。

⚠️ 教育项目：本软件“按原样”提供，不提供任何保证。请自行承担使用风险。