Eco Router

Eco Router MCP

AI エージェントがワークロードに最も低炭素なクラウドリージョンを選べるようにする MCP サーバーです。

同じ GPU ジョブでも、データセンターに電力を供給する電力網によって、CO₂排出量は数倍変わることがあります。Eco Router は AWS、Google Cloud、Azure のリージョンを、それぞれが接続する電力網に対応付けるため、エージェントは次のように尋ねられます。

「このトレーニングジョブはどこで実行すればよいですか？ データは EU 内に留め、レイテンシは 150 ms 未満にする必要があります。」

すると、順位付けされた候補リストと、その根拠が返されます。

炭素排出量の数値は、所在地に基づく電力網の平均値です。各リージョンに電力を供給する電力網を示すものであり、プロバイダーが購入する再生可能エネルギーを示すものではありません。そのため、同じ電力網に属するリージョンには同じ値が適用されます。数値が示す内容をご覧ください。

ステータス：早期リリース（v0.1）。 修正やフィードバックを歓迎します。 issuesからお寄せください。 ロードマップをご覧ください。

インストール

Node.js 22 以降が必要です。

Claude Code

claude mcp add eco-router -- npx -y eco-router-mcp

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "eco-router": {
      "command": "npx",
      "args": ["-y", "eco-router-mcp"],
      "env": { "ELECTRICITY_MAPS_API_TOKEN": "optional" }
    }
  }
}

ライブ電力網データ（任意）

初期設定では、Eco Router は年間平均値（米国では電力網ごと、カナダでは州ごと、それ以外では国ごと）を使用するため、セットアップなしで利用できます。時間単位の電力網レベルのデータを使うには、ELECTRICITY_MAPS_API_TOKEN にご自身の Electricity Maps API トークンを設定してください。ご利用のプランでカバーされていないゾーンは、自動的に年間平均値にフォールバックします。

ライブデータの利用には、ご自身の Electricity Maps プランとその利用規約が適用されます。執筆時点では、Electricity Maps は学術目的および個人の非商用利用向けに無料アクセスを提供しており、商用評価向けには 14 日間のトライアルを提供しています。商用利用には有料ライセンスが必要です。Eco Router はトークンを提供したり共有したりしません。

ツール

ツール	内容
rank_regions	電力網の炭素強度でリージョンを順位付けします。任意で、origin からの推定レイテンシとのバランスを取ることもできます。providers、countries、maxLatencyMs、maxCarbonIntensity、carbonWeight、energyKwh、limit に対応しています。
find_clean_window	柔軟なバッチジョブ向けに、各電力網ゾーンで今後 72 時間のうち、予測炭素強度が最も低くなる開始時刻と、今すぐ開始する場合と比べた削減量を見つけます。予測データへのアクセスが可能な ELECTRICITY_MAPS_API_TOKEN が必要です。
list_regions	クラウドリージョンと、各リージョンが電力を得ている電力網ゾーンを一覧表示します。provider（aws、gcp、azure）または country で絞り込めます。

countries には ISO 3166-1 alpha-2 コードと、グループ EU および EEA を指定できます。

rank_regions のリクエスト例：

{
  "countries": ["EU"],
  "origin": { "lat": 50.11, "lon": 8.68 },
  "maxLatencyMs": 40,
  "energyKwh": 500
}

2 日以内に完了する必要がある 6 時間のジョブについて、find_clean_window を呼び出すリクエスト例：

{
  "countries": ["DE", "FR", "SE"],
  "durationHours": 6,
  "withinHours": 48,
  "energyKwh": 500,
  "timezone": "Australia/Brisbane"
}

スコアリング、データソース、およびその制限については、 docs/methodology.mdで説明しています。

リージョンと電力網の対応付け、および前提に基づく対応付けについては、 docs/regions.mdに記載しています。

ロードマップ

• stdio 経由の MCP サーバーの骨格
• AWS、Google Cloud、Azure の全リージョンデータと出典
• 炭素データ：デフォルトでは公開済みの年間平均値を使用し、任意の Electricity Maps API トークンでライブデータを利用
• rank_regions：許可する国や炭素排出量の上限などの厳格な制限を指定し、炭素強度と推定レイテンシでリージョンを順位付け
• トークンなしで利用できる米国の電力網レベルの年間データ（EPA eGRID）
• トークンなしで利用できるカナダの州別年間データ（国家インベントリ報告書）
• オーストラリアの電力網レベルの年間データ
• 時間シフト：炭素排出量予測を用いて実行時刻を提案
• npm および MCP Registry で公開

開発

npm install
npm test           # unit tests, no network needed
npm run typecheck
npm run build      # compiles to dist/
npm run dev        # runs the server over stdio from source
npm run update:baseline  # refreshes national averages from Ember
npm run update:egrid     # refreshes US grid averages from EPA eGRID
npm run update:canada    # refreshes Canadian provincial averages

データソース

• 年間炭素強度：Ember, Yearly Electricity Data。 CC BY 4.0 のライセンスに基づいています。
• 米国の電力網の発電構成：US EPA eGRID（パブリックドメイン）。 Ember の米国向け係数を使用して、ライフサイクル排出量に換算しています。
• カナダの州別発電構成：Environment and Climate Change Canada の National Inventory Report, Annex 7。 Ember のカナダ向け係数を使用して、ライフサイクル排出量に換算しています。 Open Government Licence – Canada に基づいてライセンスされた情報が含まれています。
• リアルタイムの炭素強度（オプション）：出典：ElectricityMaps.com。 ご自身の API トークンを使用し、ご利用プランの規約が適用されます。
• リージョン一覧：AWS、Google Cloud、Azure の公式ドキュメント。詳しくは docs/regions.md をご覧ください。

コントリビューション

リージョンデータの修正を特に歓迎します。始めるには CONTRIBUTING.md をご覧ください。

クレジット

Eco Router はハッカソンプロジェクトとして始まりました。このプロジェクトの基盤となったスコアリング設計を考案した元チームに感謝します：Chris (@chrislee021225)、Joli (@L-Joli)、 Bob (@Loic0927)、Irene Tsai (@YunTong09) および Steven Su (@stevensu04)。

ライセンス

MIT