remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Supports loading Climatiq API key from a .env configuration file for secure credential management.
Provides repository access for the MCP server code and includes demo examples hosted on GitHub assets.
Includes example Jupyter notebook for demonstrating Climatiq API usage and carbon calculation capabilities.
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
特徴
この 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環境変数を設定します。Copy - インストール時の構成:Copy
- set-api-key ツール:
set-api-keyツールを使用して、AI アシスタント内で実行時に設定を行います。 - 構成ファイル: プロジェクト ディレクトリに
.envファイルを作成します。Copy
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ファイルを参照してください。
This server cannot be installed
AI アシスタントが Climatiq API と連携してリアルタイムの炭素排出量計算を実行し、気候への影響に関する洞察を提供できるようにするモデル コンテキスト プロトコル サーバー。