AI导哈

碳排放计算服务

Climatiq MCP Server 是一个用于访问 Climatiq API 以计算碳排放的模型上下文协议服务器，使AI助手能够实时计算碳排放并提供气候影响洞察。

  • by jagan-shanmugam
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 jagan-shanmugam/climatiq-mcp-server

使用说明

Climatiq MCP服务器

模型上下文协议（MCP）服务器，用于访问Climatiq API以计算碳排放量。这使得人工智能助手能够进行实时碳计算，并提供气候影响见解。

演示

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集成，为人工智能助手提供碳排放计算：

工具

  • 设置api密钥：配置用于身份验证的Climatiq API密钥
  • 电力排放：计算电力消耗的碳排放量
  • 旅行排放：计算汽车、飞机或火车旅行的碳排放量
  • 搜索排放因子：在Climatiq数据库中搜索特定排放因子
  • 自定义排放计算：使用特定排放系数执行自定义计算
  • 云计算排放：计算云计算资源使用的排放量
  • 货运排放：计算货运排放量
  • 采购排放：计算采购支出的排放量
  • 酒店排放：计算酒店住宿的排放量
  • 旅游支出：计算差旅费的排放量

资源

  • 碳计算结果作为资源公开 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 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. 设置api密钥工具：使用 set-api-key 在AI助手中运行时配置它的工具

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

    CLIMATIQ_API_KEY=your_climatiq_api_key

获取Climatiq API密钥：

  1. 注册地址： 网站 app.climatiq.io
  2. 请遵循以下说明 获取API密钥

运行服务器

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

climatiq-mcp-server

在AI助手中设置

克劳德桌面

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

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

示例和实用程序

示例目录

这 examples/ 目录包含：

  • 气候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工具

一种命令行界面工具，用于直接访问API，而无需MCP服务器的复杂性：

# 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. 确保 CLIMATIQ_API_KEY 在您的环境或.env文件中设置正确
  2. 验证Climatiq仪表板中的API键是否处于活动状态
  3. 使用 examples/simple_test.py 检查您的API密钥是否正常工作

高级用法

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

关于Climatiq

Climatiq为碳智能提供了强大的API，允许您计算电力使用、运输、采购等方面的排放量。此MCP服务器通过模型上下文协议使AI助手可以访问这些功能。

有关Climatiq的更多信息，请访问 气候.io.

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP