Ree MCP

🚀 ⚡ REE MCP Server

このサーバーは、クロードを介してスペインの電力網とやり取りすることができます。技術的な知識がなくても、自然言語でスペインの電力の需要、発電、価格、排出量についてクロードに質問できます。全ての技術的な詳細はクロードが処理します。

このサーバーは、Javi Santos氏（AIとロボット工学の専門家で、コンピュータビジョンとLLMの解釈可能性に関する研究を発表しています）によって、Domain-Driven DesignとClean Architectureを用いて構築されました。

💡 このようなプロジェクトの構築方法を学びたいですか？ La Escuela de IAに参加しましょう。このコミュニティでは、実際の例を用いて、スペイン語で実践的なAIを学ぶことができます。

🚀 クイックスタート

このサーバーの機能

Red Eléctrica de España (REE) は、スペインの電力網を24時間体制で管理し、5分ごとにデータを公開しています。このMCPサーバーは、クロードとの自然な会話を通じて、これらのデータにアクセスできるようにします。

実データとの会話の力

by Javi Santos

Pythonスクリプトを書く代わりに、次のような会話ができることを想像してみてください。

あなた: "2025年4月28日に何が起こったか調べて"

クロード: 電力網のデータを分析します...

🚨 重大イベント検出 - 2025年4月28日 12:35

大規模な電力網崩壊:

• 5分間で11,000MWの電力が失われました (容量の43%低下)
• システムは25,184MWから14,185MWに瞬時に低下しました
• 連鎖停電のシナリオと一致します
• 回復には10時間以上かかりました

分析:

• 11:00 - 12:30: システムは安定しており、事前の警告はありませんでした
• 12:30 - 12:35: 瞬時の壊滅的な障害
• 12:35 - 13:35: 9,635MWの最低値まで継続的に低下しました
• 原因の可能性: 原子力発電所のトリップ → 周波数の崩壊 → 連鎖反応

これは、現代史におけるスペインで最悪の停電の1つとなるでしょう。

このサーバーの力を実感できます。電力網のイベントを調査し、再生可能エネルギーと化石燃料の傾向を分析し、価格と需要を相関させることができます。全て自然言語で質問するだけです。APIドキュメントやスクリプトは必要ありません。

📦 インストール

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=tu_token_aqui

トークンの取得方法:

• テスト/デモ: .env.example に既に含まれています
• 本番環境: consultasios@ree.es にメールを送信してください

3️⃣ Claude Codeへの追加

# インストールスクリプトを実行する
./INSTALL_COMMAND.sh

# 確認する
claude mcp list

ree-mcp: ✓ Connected と表示されれば成功です。

4️⃣ 質問を始めましょう！

Claude Codeを開いて、次のような質問を試してみてください。

• "スペインの現在の電力需要を教えて"
• "現在の発電ミックスはどうなっているか"
• "今日の太陽光発電と風力発電を比較して"

💻 使用例

質問の例

📊 リアルタイムの操作

• "スペインの現在の電力需要はどれくらいですか？"
• "正午の発電ミックスを見せて"
• "スペインは昨日どれだけの電力を輸出しましたか？"
• "今日の需要を先週と比較して"
• "現在、各発電所（原子力、風力、太陽光など）はどれだけの電力を発電していますか？"

🔍 イベントの調査と分析

• "2025年4月28日に何が起こったか調べて"
• "先月、電力網に異常な活動はありましたか？"
• "今年の需要のピーク日を見つけて、その理由を説明して"
• "風力発電と価格の相関を分析して"
• "先週の異常なパターンを検出して"
• "最後の停電または重大イベントはいつでしたか？"

🌱 再生可能エネルギーと排出量

• "スペインは現在どれだけの太陽光エネルギーを発電していますか？"
• "今週の再生可能エネルギーと化石燃料の発電を比較して"
• "現在のCO₂排出量はどれくらいですか？ (gCO₂/kWh)"
• "過去30日間の風力エネルギーの傾向を見せて"
• "需要の何パーセントが再生可能エネルギーから来ていますか？"
• "今月で最もクリーンな日（CO₂排出量が最も少ない日）はいつでしたか？"

💰 価格と市場の分析

• "現在の電力のSPOT価格はどれくらいですか？"
• "今日、最も安い電力を消費する時間を見つけて"
• "平日と週末のPVPC料金を比較して"
• "今月で最も高い電力価格はいつでしたか？なぜですか？"
• "価格と再生可能エネルギーの発電の相関を見せて"

⚙️ 電力網の安定性と蓄電

• "現在の電力網の安定性はどうですか？ (同期慣性と可変再生可能エネルギーの比較)"
• "揚水発電所はエネルギーを蓄えるために使用されていますか？"
• "フランスとポルトガルとの輸入/輸出のフローを見せて"
• "電力網が水を汲み上げるのはいつですか？タービンを回すのはいつですか？"

🔎 データの発見

• "'原子力'に関連するすべての指標を検索して"
• "水力発電に関する利用可能なデータは何がありますか？"
• "すべての価格指標を見せて"
• "排出量と持続可能性に関する利用可能な指標をリストアップして"

📈 比較と傾向

• "今月の需要を昨年の同じ月と比較して"
• "過去6か月間の太陽光発電の推移を見せて"
• "先月の輸出/輸入の正味バランスを見せて"
• "再生可能エネルギーの発電が過去最高に達したのはいつですか？"

クロードは自動的に適切なツールを使用し、データを取得し、詳細な分析とともに文脈に沿って提示します。

🎓 このようなプロジェクトの構築方法を学ぶ

このプロジェクトは、**Javi Santos**氏によって作成されました。彼はAIとロボット工学の専門家で、次の分野で研究を発表しています。

• 🔬 畳み込みニューラルネットワークを使用した外科用ガーゼの検出
• 🧠 多様な知識シナリオにおける言語モデルの解釈可能性

📚 La Escuela de IA

"ホットエア"なしでAIを学び、このようなプロジェクトを構築したいですか？

La Escuela de IA に参加しましょう。このスペイン語のAI学習コミュニティでは、次のようなものが提供されています。

• 🎯 実践的なプロジェクト - おもちゃのような例ではなく、実際のAIプロジェクトを構築します
• 🇪🇸 スペイン語のコンテンツ - ついに、あなたの言語でAI教育を受けることができます
• 🛠️ 実践的なリソース - コード、チュートリアル、ハンズオンの例が用意されています
• 👥 活発なコミュニティ - 他のスペイン語圏のAI愛好家と一緒に学びましょう

👉 La Escuela de IAに参加する

📺 YouTubeチャンネル

JavadexAI のチャンネルに登録して、次のようなコンテンツを楽しみましょう。

• 🎥 AIのチュートリアルとプロジェクトの紹介
• 💡 LLMとMCPサーバーのアプリケーション
• 🚀 実世界でのAIの実装戦略

🤝 コネクト

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

🔧 技術詳細

✅ 本番環境での使用に適しています

• 指数関数的バックオフを伴う自動リトライ
• 包括的なエラー処理と検証
• 最適なパフォーマンスのためのAsync/await
• 96の包括的なテストで90%のカバレッジ

🏗️ 堅牢なアーキテクチャ

• Domain-Driven Design - 純粋なビジネスロジック
• Clean Architecture - 明確な責任分離
• SOLID原則 - 保守可能で拡張可能なコード
• 型安全 - mypyの厳格モードで100%型付けされています

📊 完全なデータ

• REEの1,967以上の指標にアクセスできます
• 5分ごとのリアルタイムデータ
• 完全な履歴データが利用可能
• 14の特別なMCPツール

🤝 コントリビュート

コントリビューションは大歓迎です！詳細な開発者ガイドについては CLAUDE.md を参照してください。

このコードは、次の厳格なアーキテクチャ原則に従っています。

• Domain-Driven Design
• Clean Architecture
• SOLID原則
• 包括的なテスト

💬 サポートとリソース

問題と質問

• サーバーの問題: Issueを作成する
• REE APIに関する質問: consultasios@ree.es

もっと学ぶ

• 📚 La Escuela de IA - スペイン語でAIを学びましょう
• 📺 JavadexAIのYouTubeチャンネル
• 🤝 Javi SantosのLinkedIn

リソース

• REEのeSios API: https://api.esios.ree.es/
• FastMCP: https://github.com/jlowin/fastmcp
• Model Context Protocol: https://modelcontextprotocol.io/

📄 ライセンス

MITライセンスと免責事項 - 詳細については LICENSE ファイルを参照してください。

⚠️ 教育用プロジェクト: このソフトウェアは「現状のまま」提供され、保証は一切ありません。自己責任で使用してください。