Climatiq MCP Server

Climatiq MCP Server

炭素排出量を計算するためにClimatiq APIへアクセスする、Model Context Protocol（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キーを設定します
• electricity-emission：電力消費による炭素排出量を計算します
• travel-emission：車、飛行機、電車での移動による炭素排出量を計算します
• search-emission-factors：Climatiqデータベース内の特定の排出係数を検索します
• custom-emission-calculation：特定の排出係数を使用してカスタム計算を実行します
• cloud-computing-emission：クラウドコンピューティングのリソース使用による排出量を計算します
• freight-emission：貨物輸送による排出量を計算します
• procurement-emission：調達支出による排出量を計算します
• hotel-emission：ホテル宿泊による排出量を計算します
• travel-spend：旅費による排出量を計算します

リソース

• 炭素排出量の計算結果は、climatiq://calculation/{id} URIスキームを持つリソースとして公開されます
• 各リソースには、排出係数と計算結果の詳細情報が含まれます

プロンプト

• climate-impact-explanation：特定の排出量計算が気候に与える影響について、自然な言葉で説明を生成します

インストール

ソースから

このプロジェクトでは、仮想環境と依存関係の管理にuvを使用します。まず、uvをインストールしてください。

# Clone the repository
git clone https://github.com/your-org/climatiq-mcp-server.git
cd climatiq-mcp-server

# Create a virtual environment
uv venv

# Activate the virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

# Install dependencies with development extras
uv sync --dev --extra all

uvを使用

uv pip install climatiq-mcp-server

APIキーの設定

サーバーを動作させるにはClimatiq APIキーが必要です。キーを設定する方法はいくつかあります。

1. 環境変数：サーバーを起動する前に、CLIMATIQ_API_KEY環境変数を設定します

   export CLIMATIQ_API_KEY=your_climatiq_api_key
   

2. インストール時の設定：

   CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-server
   

3. set-api-keyツール：AI アシスタント内で実行時にset-api-keyツールを使用して設定します

4. 設定ファイル：プロジェクトディレクトリに.envファイルを作成します：

   CLIMATIQ_API_KEY=your_climatiq_api_key
   

Climatiq APIキーを取得するには：

1. app.climatiq.ioでサインアップします
2. APIキーの取得の手順に従います

サーバーの実行

サーバーはコマンドラインから直接起動できます。

climatiq-mcp-server

AI アシスタントでのセットアップ

Claude Desktop

MacOSの場合：~/Library/Application\ Support/Claude/claude_desktop_config.json Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

"mcpServers": {
  "climatiq-mcp-server": {
    "command": "climatiq-mcp-server",
    "env": {
      "CLIMATIQ_API_KEY": "your_climatiq_api_key"
    }
  }
}

例とユーティリティ

Examplesディレクトリ

examples/ディレクトリには、以下が含まれています。

• climatiq.ipynb：Climatiq APIを直接使用する方法を示すJupyterノートブック
• simple_test.py：MCPプロトコルを使わずにAPI連携を直接テストするためのシンプルなユーティリティ

# Run the simple test
python examples/simple_test.py

ユーティリティスクリプト

utils/ディレクトリには、便利なスクリプトがいくつか含まれています。

テストクライアント

test_client.pyスクリプトは、すべてのツール、プロンプト、リソースをテストします。

python utils/test_client.py

LLMのサンプルクライアント

llm_example_client.pyスクリプトは、大規模言語モデル（Claudeなど）がClimatiq MCPサーバーとやり取りする方法を示します。

python utils/llm_example_client.py

主な機能：

• エラー処理とタイムアウト管理を備えた、完全なAPIラッパー
• 計算履歴を保持するためのリソースと結果のキャッシュ
• 自然な言葉での説明を生成する方法を示すプロンプトの例
• 電力排出量、移動による排出量、および排出係数の検索機能を実演

CLI ツール

MCP サーバーの複雑さを伴わずに API に直接アクセスできるコマンドラインインターフェースツールです。

# For electricity emissions
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US

# For travel emissions
python utils/climatiq_cli.py travel --mode car --distance 100 --unit km --region US

MCP サーバースクリプトを実行する

run_mcp_server.py スクリプトを使用すると、インストールせずにサーバーを直接実行できます。

python utils/run_mcp_server.py

主な概念

アクティビティ ID

アクティビティ ID は、類似した排出係数をグループ化する Climatiq API の重要な概念です。

• Climatiq データベース内の各排出係数にはアクティビティ ID があります
• アクティビティ ID は、地域、年、ソースなどが異なっても、同じ活動を表す排出係数をグループ化します
• 例：electricity-supply_grid-source_residual_mix（電力）、passenger_vehicle-vehicle_type_car（自動車移動）

計算方法

Climatiq MCP サーバーは、複数の計算方法に対応しています。

1. 移動距離ベースの方法：移動による排出量を計算します
2. 高度な移動計算：出発地と目的地の組み合わせを使用します
3. 支出額ベースの方法：支出データのみがある場合に使用します
4. 直接計算：特定の排出係数を使用します

トラブルシューティング

API キーの問題

1. 環境または .env ファイルで CLIMATIQ_API_KEY が正しく設定されていることを確認してください
2. Climatiq ダッシュボードで API キーが有効であることを確認してください
3. examples/simple_test.py を使用して、API キーが正しく機能するか確認してください

高度な使い方

特定のツールや高度な機能の詳しいドキュメントについては、docs/README.md ファイルを参照してください。

Climatiq について

Climatiq は、電力の使用、輸送、調達などによる排出量を計算できる、強力なカーボンインテリジェンス API を提供しています。この MCP サーバーにより、Model Context Protocol を通じて、AI アシスタントがこれらの機能を利用できるようになります。

Climatiq の詳細については、climatiq.io をご覧ください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。