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 。

使用 uv

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 工具：使用set-api-key工具在 AI 助手运行时进行配置

4. 配置文件：在项目目录中创建一个.env文件：

   CLIMATIQ_API_KEY=your_climatiq_api_key

要获取 Climatiq API 密钥：

1. 在app.climatiq.io注册

2. 按照获取 API 密钥中的说明进行操作

运行服务器

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

AI助手中的设置

克劳德桌面

在 MacOS 上： ~/Library/Application\ Support/Claude/claude_desktop_config.json在 Windows 上： %APPDATA%/Claude/claude_desktop_config.json

示例和实用程序

示例目录

examples/目录包含：

• climatiq.ipynb ：一个 Jupyter 笔记本，演示了如何使用 Climatiq 直接使用 API

• 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 服务器支持多种计算方法：

1. 基于距离的出行排放方法

2. 使用出发地-目的地对进行高级旅行计算

3. 当您只有支出数据时**，采用基于支出的方法**

4. 使用特定排放因子直接计算

故障排除

API 密钥问题

1. 确保在您的环境或 .env 文件中正确设置CLIMATIQ_API_KEY

2. 验证 API 密钥在 Climatiq 仪表板中是否处于活动状态

3. 使用examples/simple_test.py检查你的 API 密钥是否正常工作

高级用法

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

关于Climatiq

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

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

执照

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