Emission Factors

emission-factors MCP サーバー

Claude、Cursor、Cline、または任意のMCPクライアントに、ZIP コード別の米国の電力データへのリアルタイムアクセスを提供します。グリッドの炭素排出係数、小売料金、時間別のグリッド炭素強度、発電所の排出量、電力会社の料金プランを利用できます。

emission-factors.comを基盤としており、EPA eGRID、EIA-861、EIA-930、EPA CAMD、OpenEI URDB を ZIP コードで検索できる単一の API にまとめています。

無料です。API キーも登録も不要です。 API には IP ごとにレート制限（1 時間あたり 2,000 リクエスト）があります。

---

質問できること

接続すると、エージェントは次のような質問に回答できます。

• 「ZIP コード 94105 にある本社の年間電力使用量は 120 万 kWh です。スコープ 2 の炭素排出量と年間電気料金はいくらですか？」
• 「新しいデータセンターの候補地として、デンバー、オースティン、コロンバスを、グリッドの炭素強度と電気料金で比較してください。」
• 「今週、カリフォルニアで 500 kW のバッチジョブを実行するのに、最もクリーンな時間帯はいつですか？」
• 「この 40 店舗の ZIP コード一覧に、各拠点の排出係数とカーボンフリー率を追加してください。」
• 「先週の CO2 排出量で見ると、テキサスで最も汚染度の高い発電所はどこですか？」
• 「10 MW のデータセンターについて、炭素排出量と電力コストの観点から、バージニア州アッシュバーン、テキサス州アビリーン、オレゴン州ザ・ダレスを順位付けしてください。」
• 「当社の工場では、年間 40,000 サームのガスと 3,000 ガロンのディーゼルを燃焼しています。スコープ 1 の排出量はいくらですか？」
• 「州平均ではなく、ZIP コード 94105 の PG&E の実際の住宅用料金プランを教えてください。」

利用する理由

• スコープ 2 の炭素会計 - 米国の 33,700 以上の ZIP コードについて、GHG Protocol に準拠したロケーション基準およびマーケット基準の排出係数を提供します（CDP、CSRD、カリフォルニア州 SB 253 の入力データ）。
• 立地選定 - 1 回の会話で、候補地を炭素強度 と 電気料金の両面から比較できます。
• デマンドレスポンスと負荷シフトの分析 - EIA-930 に基づく時間別のグリッド炭素データを利用できます（系統内発電に対する燃料別の固定係数です。時間帯の選定向けであり、インベントリ報告向けではありません）。
• 発電所単位の排出量 - 25 MW 超の化石燃料ユニットを対象とした EPA CAMD データを提供します。施設別の概要またはユニット・時間別の記録を四半期ごとに公開しています。
• エージェントと自動化 - LLM が排出係数を捏造せず、信頼できる政府データを取得できるよう、使いやすいツールを提供します。

---

クイックスタート

実行方法は 2 つあります。ほとんどの方にはオプション Aがおすすめです。

オプション A - リモートサーバー（推奨、インストール不要）

インストールは不要で、常に最新の状態で利用できます。ホストされているエンドポイントは https://emission-factors.com/mcp です（Streamable HTTP、キー不要）。

Claude（ウェブ、デスクトップアプリ、モバイル） - Claude に追加。リンクを開くと、名前と URL が入力済みの Claude のカスタムコネクター画面が表示されます。Add、続いてConnectを選択してください。手動で設定する場合：Customize -> Connectors -> Add custom connector を選び、URL に https://emission-factors.com/mcp を指定し、OAuth フィールドは空欄にします。

Claude Code

claude mcp add --transport http emission-factors https://emission-factors.com/mcp

Cursor - ~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "emission-factors": {
      "url": "https://emission-factors.com/mcp"
    }
  }
}

Cline / Continue / Zed / その他のクライアント - URL https://emission-factors.com/mcp を指定して、リモート（Streamable HTTP）MCP サーバーを追加します。キーは不要です。

Claude Desktop の claude_desktop_config.json で起動できるのはローカル（stdio）サーバーのみです。ここに "url" エントリを記述しても機能しません。上記のコネクターリンクを使用するか、オプション B を選択してください。

オプション B - ローカル stdio サーバー（このパッケージ）

同じ公開 API をプロキシするローカルプロセスとしてサーバーを実行します。stdio トランスポートのみをサポートするクライアントや、セルフホストしたい場合に便利です。

GitHub から直接実行します（インストール時にビルドされます。Node 18+ が必要です）。

{
  "mcpServers": {
    "emission-factors": {
      "command": "npx",
      "args": ["-y", "github:rozetyp/emission-factors-mcp"]
    }
  }
}

または、ソースをクローンして実行します。

git clone https://github.com/rozetyp/emission-factors-mcp.git
cd emission-factors-mcp
npm install        # builds dist/ via the prepare script

{
  "mcpServers": {
    "emission-factors": {
      "command": "node",
      "args": ["/absolute/path/to/emission-factors-mcp/dist/index.js"]
    }
  }
}

オプションの環境変数：EMISSION_FACTORS_API_BASE（デフォルトは https://emission-factors.com）。独自の API インスタンスを実行する場合に設定します。

---

ツール

米国の ZIP コード（または、記載されている場合は直接コード）をキーとする 11 個のツールです。リモートサーバーとこの stdio ビルドは、同じツールセットを公開します。

ツール	目的	主な入力
lookup_emission_factor	ZIP コードの EPA eGRID CO2e と発電構成全体を検索	zip
lookup_by_coordinates	Census ジオコーダーで緯度・経度から特定	lat、lon
lookup_batch	最大 100 件の ZIP コードの排出係数を一度に取得	zips[]
calculate_emissions	ZIP コードと kWh のスコープ 2 CO2e（ロケーション基準およびマーケット基準（Green-e 残余ミックス））を計算	zip、kwh、renewable_kwh
hourly_intensity	1 時間ごとの電力網の炭素強度（EIA-930、約 24 時間遅れ）	zip または ba、hours
plant_emissions	発電所の排出量（EPA CAMD）：施設の概要またはユニットごとの時間単位の記録	facility_id または state、days
utility_tariff	州平均ではなく、電力会社固有の料金表（OpenEI URDB）	zip、utility、または eiaid
electricity_rate	部門別の州平均小売料金（EIA-861）	zip
compare_sites	電力網の炭素強度、$/kWh、1 日で最もクリーンな時間帯に基づいて、候補地 2～25 件を順位付け	zips[]、annual_kwh、sector
cleanest_hours	柔軟に調整可能な負荷を実行する、現地時間で 1 日のうち最もクリーンな N 時間枠	zip または ba、duration
calculate_fuel_emissions	現地で燃焼した燃料のスコープ 1 CO2e（EPA GHG Emission Factors Hub）を計算	items[]：fuel、quantity、unit

すべてのツールは JSON を返します。正確なレスポンス形式については、API ドキュメント全文を参照してください。

---

データソース

データ	ソース	備考
電力網の排出係数	EPA eGRID2023 Rev2（および year=2024 経由の Cornerstone の eGRID2024）	年次、ロケーション基準、27 のサブリージョン
残余ミックス（マーケット基準のスコープ 2）	Green-e Residual Mix 2025（2023 年のデータ）	eGRID のサブリージョンごと
燃料燃焼係数（スコープ 1）	GHG Emission Factors Hub 2026（Cornerstone、EPA の Hub の後継）；edition 経由の EPA 2025	63 種類の燃料、AR6 の GWP（2025 年版は AR5）
小売電気料金	EIA Form 861	部門別、州単位の月平均
1 時間ごとの電力網の炭素強度	EIA-930	1 時間ごとの燃料構成から算出、約 24 時間遅れ
発電所レベルの排出量	EPA CAMD	25 MW 超の化石燃料ユニット。四半期ごとに公表（四半期末から 45 日以上後）
電力会社固有の料金表	OpenEI URDB（NREL）	EIA ID に基づいて ZIP コードを電力会社に紐付け
ZIP コード／緯度・経度の解決	US Census（ZCTA + Geocoder）	ZIP コードから eGRID サブリージョンへのマッピング

レート制限と認証

• API キーも登録も不要です。 すべてのリクエストは匿名です。
• IP ごとに 1 時間あたり 2,000 リクエスト。 対話的な利用には十分な上限です。上限に達すると、retryAfter のヒントを含む HTTP 429 が返されます。
• 外部データのエンドポイントはサーバー側でキャッシュされます（料金は 24 時間、1 時間ごとの炭素強度は 1 時間、料金表は 7 日間、発電所の排出量は 24 時間）。そのため、繰り返しの呼び出しは高速で、上流の割り当ても消費しません。

その他の利用方法

• REST API - 同じデータをプレーン HTTP で取得できます：curl "https://emission-factors.com/api/lookup?zip=94105"。API ドキュメントと OpenAPI 仕様を参照してください。
• ホスト型 MCP セットアップガイド - emission-factors.com/mcp-setup
• エージェント向けの機械可読な概要 - emission-factors.com/llms.txt

---

開発

npm install        # install deps and build (prepare -> tsc)
npm run build      # compile TypeScript to dist/
npm run dev        # watch mode
npm start          # run the built server over stdio

MCP Inspector で簡単なスモークテストを実行します。

npx @modelcontextprotocol/inspector node dist/index.js

このサーバーは薄いプロキシです。各ツールは emission-factors.com の /api/* エンドポイントに対応し、入力を検証して JSON レスポンスを返します。ローカル状態はなく、キーの処理もありません。

ライセンス

MIT — LICENSE を参照してください。データはそれぞれの米国政府機関（EPA、EIA、Census）および NREL/OpenEI に帰属します。このプロジェクトと API は非公式のラッパーであり、これらの機関とは提携していません。