Climatiq MCP 服务器

一个模型上下文协议 (MCP) 服务器，用于访问 Climatiq API 来计算碳排放量。这使得 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 数据库中搜索特定的排放因子
自定义排放计算：使用特定的排放因子执行自定义计算
cloud-computing-emission ：计算云计算资源使用产生的排放量
货运排放：计算货运排放量
采购排放：计算采购支出的排放量
酒店排放：计算酒店住宿产生的排放量
travel-spend ：计算旅行费用的排放量

资源

碳计算结果以climatiq://calculation/{id} URI 方案的形式公开为资源
每个资源都包含有关排放因子和计算结果的详细信息

提示

气候影响解释：生成关于特定排放计算对气候影响的自然语言解释

安装

来自源

本项目使用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 密钥才能运行。您可以通过多种方式提供密钥：

环境变量：在启动服务器之前设置CLIMATIQ_API_KEY环境变量
export CLIMATIQ_API_KEY=your_climatiq_api_key
安装期间的配置：
CLIMATIQ_API_KEY=your_climatiq_api_key uv pip install climatiq-mcp-server
set-api-key 工具：使用set-api-key工具在 AI 助手运行时进行配置
配置文件：在项目目录中创建一个.env文件：
CLIMATIQ_API_KEY=your_climatiq_api_key

要获取 Climatiq API 密钥：

在app.climatiq.io注册
按照获取 API 密钥中的说明进行操作

运行服务器

可以直接从命令行启动服务器：

climatiq-mcp-server

AI助手中的设置

克劳德桌面

在 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/目录包含：

climatiq.ipynb ：一个 Jupyter 笔记本，演示了如何使用 Climatiq 直接使用 API
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 服务器支持多种计算方法：

基于距离的出行排放方法
使用出发地-目的地对进行高级旅行计算
当您只有支出数据时**，采用基于支出的方法**
使用特定排放因子直接计算

故障排除

API 密钥问题

确保在您的环境或 .env 文件中正确设置CLIMATIQ_API_KEY
验证 API 密钥在 Climatiq 仪表板中是否处于活动状态
使用examples/simple_test.py检查你的 API 密钥是否正常工作

高级用法

有关使用特定工具和高级功能的详细文档，请参阅docs/README.md文件。

关于Climatiq

Climatiq 提供强大的碳智能 API，让您能够计算电力使用、交通运输、采购等领域的排放量。该 MCP 服务器通过模型上下文协议 (MCP) 将这些功能提供给 AI 助手。

有关 Climatiq 的更多信息，请访问climatiq.io 。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

Climatiq MCP Server

Integrations