Climatiq MCP サーバー
Climatiq APIにアクセスして炭素排出量を計算するためのモデルコンテキストプロトコル（MCP）サーバー。これにより、AIアシスタントはリアルタイムの炭素計算を実行し、気候への影響に関する洞察を提供できるようになります。
デモ
https://github.com/user-attachments/assets/c253d6d1-ccf6-4c14-965e-6023ba2a0296
https://github.com/user-attachments/assets/d61c1181-acf6-4d9f-9a48-537fc64ac4c3
Related MCP server: MCP Weather Server
特徴
この MCP サーバーは Climatiq API と統合して、AI アシスタントの炭素排出量計算を提供します。
ツール
set-api-key : 認証に使用するClimatiq APIキーを設定します
電力消費からの二酸化炭素排出量を計算する
travel-emission : 車、飛行機、電車での移動による二酸化炭素排出量を計算します
search-emission-factors : Climatiqデータベースで特定の排出係数を検索します
custom-emission-calculation : 特定の排出係数を使用してカスタム計算を実行する
cloud-computing-emission : クラウドコンピューティングリソースの使用による排出量を計算します
貨物輸送からの排出量を計算する
procurement-emission : 調達支出からの排出量を計算する
hotel-emission : ホテル滞在による排出量を計算する
旅行費用：旅行費用からの排出量を計算する
リソース
炭素計算の結果は
climatiq://calculation/{id}URIスキームを持つリソースとして公開されます。各リソースには、排出係数と計算結果に関する詳細な情報が含まれています。
プロンプト
climate-impact-explanation : 特定の排出量計算による気候への影響について自然言語による説明を生成する
インストール
ソースから
このプロジェクトでは、仮想環境と依存関係の管理にuvを使用します。必ず事前にUVをインストールしてください。
UVの使用
APIキーの設定
サーバーが機能するにはClimatiq APIキーが必要です。APIキーの提供方法はいくつかあります。
環境変数: サーバーを起動する前に、
CLIMATIQ_API_KEY環境変数を設定します。export CLIMATIQ_API_KEY=your_climatiq_api_keyインストール時の構成:
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-serverset-api-key ツール:
set-api-keyツールを使用して、AI アシスタント内で実行時に設定を行います。構成ファイル: プロジェクト ディレクトリに
.envファイルを作成します。CLIMATIQ_API_KEY=your_climatiq_api_key
Climatiq API キーを取得するには:
app.climatiq.ioでサインアップ
APIキーの取得の手順に従ってください。
サーバーの実行
サーバーはコマンドラインから直接起動できます。
AIアシスタントのセットアップ
クロードデスクトップ
MacOS の場合: ~/Library/Application\ Support/Claude/claude_desktop_config.json Windows の場合: %APPDATA%/Claude/claude_desktop_config.json
例とユーティリティ
例ディレクトリ
examples/ディレクトリには次のものが含まれます。
climatiq.ipynb : Climatiq で直接 API を使用する方法を示す Jupyter ノートブック
simple_test.py : MCPプロトコルを使用せずにAPI統合を直接テストするためのシンプルなユーティリティ
ユーティリティスクリプト
utils/ディレクトリには、いくつかの便利なスクリプトが含まれています。
テストクライアント
test_client.pyスクリプトは、すべてのツール、プロンプト、およびリソースをテストします。
LLM サンプルクライアント
llm_example_client.pyスクリプトは、大規模言語モデル (Claude など) が Climatiq MCP サーバーと対話する方法を示しています。
主な機能:
エラー処理とタイムアウト管理を備えた完全な API ラッパー
計算履歴を保存するためのリソースと結果のキャッシュ
自然言語による説明を生成する方法を示すサンプルプロンプト
電力排出量、移動排出量、排出係数の検索機能を実証します
CLIツール
MCP サーバーの複雑さなしで直接 API にアクセスするためのコマンドライン インターフェイス ツール:
MCP サーバー スクリプトを実行する
インストールせずにサーバーを直接実行するには、 run_mcp_server.pyスクリプトを使用します。
重要な概念
アクティビティID
アクティビティ ID は、Climatiq の API における重要な概念であり、同様の排出係数をグループ化します。
Climatiqデータベースの各排出係数にはアクティビティIDがある
アクティビティ ID は、地域、年、ソースなど全体で同じアクティビティを表す排出係数をグループ化します。
例:
electricity-supply_grid-source_residual_mix（電力）、passenger_vehicle-vehicle_type_car（自動車旅行）
計算方法
Climatiq MCP サーバーは複数の計算方法をサポートしています。
移動排出量に対する距離ベースの方法
出発地と目的地の組み合わせによる高度な旅行計算
支出データしかない場合の支出ベースの方法
特定の排出係数を使用した直接計算
トラブルシューティング
APIキーの問題
環境または.envファイルで
CLIMATIQ_API_KEYが正しく設定されていることを確認してくださいClimatiqダッシュボードでAPIキーが有効になっていることを確認します
examples/simple_test.pyを使用して、API キーが正しく機能するかどうかを確認します。
高度な使用法
特定のツールや高度な機能の使用に関する詳細なドキュメントについては、 docs/README.mdファイルを参照してください。
Climatiqについて
Climatiqは、電力使用量、輸送、調達などからの排出量を計算できる強力な炭素インテリジェンスAPIを提供しています。このMCPサーバーは、モデルコンテキストプロトコルを介してAIアシスタントがこれらの機能にアクセスできるようにします。
Climatiq の詳細については、 climatiq.io をご覧ください。
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。