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 文件。

⚠️ 教育項目：本軟件“按原樣”提供，不提供任何保證。請自行承擔使用風險。