项目介绍
⚡ REE MCP Server
<div align="center">

</div>
通过Claude与西班牙电网对话——无需技术知识
使用自然语言向Claude询问西班牙电力的需求、发电、价格和排放。他负责处理所有的技术细节。
由Javi Santos使用领域驱动设计和干净架构构建——人工智能和机器人领域的专家,发表过计算机视觉和大型语言模型可解释性的研究。
💡 想学习如何构建这样的项目吗? 加入La Escuela de IA——一个你可以学习实用AI的社区,没有花哨的内容,只有真实的西班牙语例子。
🎯 这个服务器做什么?
Red Eléctrica de España (REE) 24/7管理西班牙电网,并每5分钟发布数据。这个MCP服务器通过与Claude的自然对话使这些数据变得可用。
使用真实数据进行对话的力量
由Javi Santos
无需编写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文档。无需脚本。只需提问。
🚀 安装(3分钟)
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=你的令牌在这里
获取令牌:
3️⃣ 添加到Claude Code
# 执行安装脚本
./INSTALL_COMMAND.sh
# 验证
claude mcp list
你应该看到ree-mcp: ✓ 已连接。
4️⃣ 完成!开始提问吧
打开Claude Code并尝试:
- "显示当前西班牙的电力需求"
- "现在的发电混合是什么?"
- "比较今天的太阳能和风能发电"
💬 你可以问什么?
📊 实时操作
- "现在西班牙的电力需求是多少?"
- "显示中午的发电混合"
- "西班牙昨天出口了多少能量?"
- "比较今天的需求与上周"
- "现在每个发电站正在生成什么?(核能、风能、太阳能...)"
🔍 事件调查与分析
- "调查2025年4月28日发生了什么"
- "上个月电网是否有异常活动?"
- "找出今年需求峰值的一天并解释原因"
- "分析风能发电与价格之间的相关性"
- "检测过去一周中的异常模式"
- "上次发生停电或关键事件是什么时候?"
🌱 可再生能源与排放
- "西班牙目前产生了多少太阳能?"
- "比较本周的可再生能源与化石能源发电"
- "当前的二氧化碳排放量是多少?(gCO₂/kWh)"
- "显示过去30天的风能趋势"
- "有多少比例的需求来自可再生能源?"
- "本月最清洁的一天是什么时候?(二氧化碳最少)"
💰 价格与市场分析
- "现在的现货电价是多少?"
- "找出今天最便宜的用电时段"
- "比较工作日和周末的PVPC费率"
- "本月什么时候电价最高?为什么?"
- "显示价格与可再生能源发电之间的相关性"
⚙️ 电网稳定性与储能
- "电网的稳定性如何?(同步惯性与可变可再生能源)"
- "抽水蓄能电站是否正在用于储能?"
- "显示与法国和葡萄牙的进出口流量"
- "何时抽水,何时放水?"
🔎 数据发现
- "查找所有与'核能'相关的指标"
- "有关水电发电的数据有哪些?"
- "显示所有价格指标"
- "列出所有排放和可持续性指标"
📈 比较与趋势
- "比较本月的需求与去年同期"
- "过去六个月太阳能发电是如何发展的?"
- "显示上个月的净进出口平衡"
- "我们何时达到历史最高的可再生能源发电峰值?"
Claude会自动使用正确的工具,获取数据,并在上下文中提供详细的分析。
🎓 学习如何构建这样的项目
此项目由**Javi Santos**创建,他是人工智能和机器人领域的专家,发表了以下研究:
- 🔬 使用卷积神经网络检测手术纱布
- 🧠 在多样化知识场景下的语言模型可解释性
📚 La Escuela de IA
想要学习实用的人工智能并构建这样的项目吗?
加入**La Escuela de IA**——一个西班牙语的人工智能学习社区,在这里你可以找到:
- 🎯 实际操作——构建真正的AI项目,而不是玩具示例
- 🇪🇸 西班牙语内容——终于有人工智能教育是用你的语言提供的
- 🛠️ 实用资源——代码、教程和动手实践的例子
- 👥 活跃社区——与其他西班牙语的AI爱好者一起学习
👉 加入La Escuela de IA
📺 YouTube频道
订阅**JavadexAI**以获得:
- 🎥 AI教程和项目巡演
- 💡 LLM应用和服务MCP
- 🚀 如何在现实世界中实施AI策略
🤝 联系方式
🔥 技术特性
✅ 生产就绪
- 自动重试带有指数退避
- 详尽的错误处理和验证
- 使用async/await实现最佳性能
- 96个详尽的测试,覆盖率90%
🏗️ 坚固的架构
- 领域驱动设计——纯粹的业务逻辑
- 干净架构——清晰的责任分离
- SOLID原则——可维护和可扩展的代码
- 类型安全——使用严格模式的mypy 100%类型化
📊 完整数据
- 访问1.967+个REE指标
- 每5分钟实时数据
- 完整的历史数据
- 14个专门的MCP工具
🤝 贡献
欢迎贡献!查看CLAUDE.md以获取详细的开发者指南。
此代码遵循严格的架构原则:
- 领域驱动设计
- 清洁架构
- SOLID原则
- 详尽的测试
💬 支持与资源
问题与疑问
更多了解
资源
📄 许可
MIT许可附带免责声明——详情见LICENSE文件。
⚠️ 教育项目:此软件按原样提供,不作任何保证。自行承担风险使用。
<div align="center">
使用领域驱动设计和现代Python最佳实践构建
⭐ 如果这个repo对你有帮助,请给它点赞!
</div>