Stroomr Mcp

StroomR MCP

「いつ電気を使うべきか」という質問に、ライブの Nord Pool 価格、地域の太陽光発電予測、すぐに使える負荷シフトのアドバイスをまとめて、1 回の呼び出しで AI アシスタントが回答できるようにします。

StroomR が開発しました。欧州の前日電力市場と家庭でのエネルギー利用タイミングに特化しており、汎用的な天気予報や金融向け API ではありません。

---

エージェントでできること

タスク	このサーバーを使わない場合	StroomR MCP を使う場合
EV の充電アドバイス	エージェントが推測するか、複数のアプリを確認するようユーザーに求めます	ツールを 1 回呼び出すだけで、最適な時間帯、節約額の見積もり、避けるべき時間帯がわかります
ヒートポンプ／バッテリーの使用タイミング	手動で価格を調べ、天気も確認します	価格と太陽光発電の重複時間を構造化された出力でまとめて確認できます
「明日は晴れますか？」＋「電気料金は安いですか？」	2 回別々に検索し、エージェントが情報を統合します	負荷シフトの判断に使える情報を、1 回でまとめて取得できます

**仕組みではなく、成果を重視：**生の API 出力の代わりに、あらかじめ統合された情報と構造化フィールド（recommendedWindows、avoidWindows、estimatedSavingsVsAvgEur）を使い、エージェントが少ない手順でエネルギー利用のタイミングに関するタスクを完了できます。

---

最適なユースケース

1. 「明日、EV を充電するのはいつがよいですか？」 — 最も安い連続した時間帯、平均価格と比べた節約額の見積もり、避けるべき夕方のピーク時間帯。
2. 「今日、ヒートポンプを使う最適な時間は？」 — 自家消費向けの太陽光発電との重複時間を含む、価格順の時間帯。
3. 「明日は晴れますか？電気料金は安いですか？」 — 太陽光発電や負荷の判断に使える、天気と Nord Pool のスナップショット。
4. 「今週、電気を使うのに最も安い時間帯は？」 — 今日と明日の前日市場の時間帯。
5. 「今日はどれくらい日が照りますか？」 — 指定した場所の日照時間、日照時間帯、雨の時間帯。

**対象範囲：**欧州の Nord Pool 前日市場（NL、GER、DK1、SE3 など）。リアルタイム取引、送電網運用者のデータ、欧州以外の電力会社には対応していません。

---

対応クライアント

以下を含む、MCP 対応のアシスタントであれば利用できます。

• Cursor（ローカル stdio — 設定はこのリポジトリに含まれています）
• Claude Desktop（claude_desktop_config.json に追加）
• stdio サーバーに対応するその他の MCP ホスト（ChatGPT のデスクトップ連携、カスタムエージェントなど）

Node.js 20 以降が必要です。お使いのマシン上でローカルに実行されます。MCP の利用に StroomR アカウントは必要ありません。

---

認証と安全性

実行方法	stdio 経由でローカルに実行（node dist/index.js）
認証情報	不要 — API キーも StroomR へのログインも必要ありません
ネットワーク	Open-Meteo（天気）および Nord Pool の公開前日市場 API（価格）への読み取り専用の送信リクエスト
書き込み	なし — デバイス、メーター、家庭内の機器を制御しません
送信データ	場所（都市名または座標）と Nord Pool のエリア — ツールの引数または環境設定で渡した情報のみ

環境変数でデフォルトの場所を設定しておけば、エージェントが毎回確認する必要はありません。

"env": {
  "STROOMR_CITY": "Amsterdam",
  "STROOMR_PRICE_AREA": "NL"
}

---

使用例

例 1 — EV の充電（主なユースケース）

ユーザーのプロンプト：

明日、EV を充電するのはいつがよいですか？

エージェントのアクション： get_load_shift_advice · { "device": "ev", "day": "tomorrow" }

エージェントの回答（構造化された出力に基づく）：

明日は 10:00–14:00 に充電してください。11 kW で 4 時間充電する場合、卸売価格の平均と比べて €3.73 の節約が見込まれます。17:00–23:00 は夕方のピーク時間帯なので避けてください。予想される日照時間と重なるため、太陽光発電の自家消費にも適しています。

---

例 2 — 今日のヒートポンプ

ユーザーのプロンプト：

今日、ヒートポンプを使う最適な時間は？

エージェントのアクション： get_load_shift_advice · { "device": "heat_pump", "day": "today" }

エージェントの回答：

今日は 14:00–18:00 に集中的に暖房運転してください（12 kWh の場合、平均より約 €0.68 安くなります）。19:00–23:00 は避けてください。

---

例 3 — 天気と価格をまとめて取得

ユーザーのプロンプト：

明日は、安く充電できて太陽光発電にも適した日ですか？

エージェントのアクション： get_weather_and_prices · { "days": 2 }

エージェントの回答：

明日は、約 15 時間の日照（07:00–21:00）があり、日中の前日市場価格はほぼゼロです。負荷を日中に移すのに最適な日です。

---

ツール（目的別に設計された5つ）

ツール	エージェントの役割
get_load_shift_advice	メインツール。 EV、ヒートポンプ、蓄電池に最適な時間帯と避けるべき時間帯、節約額の見積もり、太陽光発電との重なり
get_weather_and_prices	エージェントが日照と価格の両方の情報を必要とする場合に使う統合スナップショット
get_energy_prices	Nord Pool の現在および翌日の前日市場価格枠のうち、最安・最高の時間帯
get_weather_forecast	日照時間帯、降雨期間、降水量 — 太陽光発電が重要な場合に使用
resolve_location	都市・座標を検証し、Nord Pool の価格エリアを特定

負荷シフトのアドバイスに使用するデフォルト値：

デバイス	device	電力	時間
EV 充電器	ev	11 kW	4 h
ヒートポンプ	heat_pump	3 kW	4 h
家庭用蓄電池	battery	5 kW	2 h

power_kw と duration_hours で上書きできます。

---

インストール

npm から（公開後）

{
  "mcpServers": {
    "stroomr": {
      "command": "npx",
      "args": ["-y", "@nixman2/stroomr-mcp"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL"
      }
    }
  }
}

ソースから

npm install
npm run build

Cursor（ローカル開発）

.cursor/mcp.json：

{
  "mcpServers": {
    "stroomr": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL",
        "STROOMR_OUTPUT_FORMAT": "structured"
      }
    }
  }
}

MCP 設定を変更した後は、Cursor を再起動してください。

Claude Desktop

{
  "mcpServers": {
    "stroomr": {
      "command": "node",
      "args": ["/absolute/path/to/stroomr-mcp/dist/index.js"],
      "env": {
        "STROOMR_CITY": "Amsterdam",
        "STROOMR_PRICE_AREA": "NL"
      }
    }
  }
}

---

設定

変数	説明
STROOMR_CITY	デフォルトの都市（ジオコーディング済み）
STROOMR_LAT / STROOMR_LON	デフォルトの座標
STROOMR_PRICE_AREA	Nord Pool のエリア（例：NL）
STROOMR_CURRENCY	デフォルトは EUR
STROOMR_TIMEZONE	タイムゾーンの上書き
STROOMR_OUTPUT_FORMAT	friendly（デフォルト）または structured

優先順位： ツールの引数 → 環境変数 → 明確なエラー（デフォルトの都市を黙って使用することはありません）。

構造化レスポンスには、stroomr のブランディングブロックと、エージェントによる解析に最適化されたフィールド（recommendedWindows、cheapestSlot、summary_nl）が含まれます。

---

動作確認

npm run smoke-test

---

StroomR について

この MCP は、動的料金と太陽光発電量に合わせて EV の充電、ヒートポンプ、蓄電池の稼働時間を自動調整するエネルギー管理サービス StroomR の負荷シフトロジックを体験できる無料デモです。

アシスタントに頼らず、24 時間 365 日稼働させたいですか？ 無料パイロットに参加 →

---

データソースと免責事項

• 天気：Open-Meteo（CC BY 4.0）
• 価格：Nord Pool Group の前日市場価格。コミュニティが文書化した公開 API を使用しています（非公式のため、変更される可能性があります）。

負荷シフトのアドバイスには、卸売りの前日市場価格を使用します。小売料金には税金、送配電網利用料、電力会社の上乗せ料金が含まれます。節約額の見積もりは参考値であり、保証されません。

対応する Nord Pool エリア： DK1、DK2、FI、NO1–NO5、SE1–SE4、EE、LT、LV、AT、BE、FR、GER、NL、PL、BG、TEL

---

MCP レジストリへの公開

公式 MCP レジストリのクイックスタートに合わせて準備されています。

手順	状態
1. package.json の mcpName	✅ io.github.nixman2/stroomr-mcp
2. npm に公開	⏳ ローカルで実行（npm へのログインが必要）
3. mcp-publisher をインストール	✅
4. server.json を作成	✅ 検証済み
5. mcp-publisher login github	—
6. mcp-publisher publish	—

手順 2 — npm に公開：

npm adduser          # if not logged in
npm publish --access public

手順 5～6 — レジストリのメタデータを公開：

mcp-publisher login github
mcp-publisher publish

掲載状況を確認：

curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.nixman2/stroomr-mcp"

レジストリ名：io.github.nixman2/stroomr-mcp · npm：@nixman2/stroomr-mcp

---

Cursor Directory に登録する

cursor.directory は、Open Plugins のコンポーネントをリポジトリのルートからスキャンします。このリポジトリには、以下が含まれています。

パス	用途
mcp.json	MCP サーバーの設定（ディレクトリのスキャンに必須）
.cursor-plugin/plugin.json	プラグインのマニフェスト
skills/stroomr-energy/SKILL.md	エネルギーのタイミングに関する質問に対応するエージェントスキル

GitHub にプッシュした後、https://github.com/nixman2/stroomr-mcp を指定して、Submit a Plugin → Auto (GitHub) から再スキャンします。

注： mcp.json は npx @nixman2/stroomr-mcp を使用するため、先に npm への公開を成功させる必要があります。ローカル開発では引き続き .cursor/mcp.json を使用します。