STARWARCLOUD STARWAR.AI
返回市场
气候计算mcp服务器

气候计算mcp服务器

作者：jagan-shanmugam6 星标更新：2025-03-29
安装使用来源：spider==github.com

项目介绍

Climatiq MCP Server

License: MIT 

这是一个用于访问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: 计算旅行费用的碳排放

资源

  • 碳排放计算结果作为资源暴露，URI方案为climatiq://calculation/{id}
  • 每个资源包含关于排放因子和计算结果的详细信息

提示

  • climate-impact-explanation: 生成关于特定排放计算对气候影响的自然语言解释

安装

从源码安装

该项目使用uv进行虚拟环境和依赖管理。首先确保已安装uv。

# 克隆仓库
git clone https://github.com/your-org/climatiq-mcp-server.git
cd climatiq-mcp-server

# 创建虚拟环境
uv venv

# 激活虚拟环境
# 在macOS/Linux上：
source .venv/bin/activate
# 在Windows上：
.venv\Scripts\activate

# 安装带有开发额外项的依赖
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

<details> <summary>配置示例</summary> 
"mcpServers": {
  "climatiq-mcp-server": {
    "command": "climatiq-mcp-server",
    "env": {
      "CLIMATIQ_API_KEY": "your_climatiq_api_key"
    }
  }
}
</details>

示例和实用程序

示例目录

examples/目录包含：

  • climatiq.ipynb: 一个演示直接使用Climatiq API的Jupyter笔记本
  • simple_test.py: 一个简单的测试工具，用于直接测试API集成而不涉及MCP协议
# 运行简单测试
python examples/simple_test.py

实用脚本

utils/目录包含几个有用的脚本：

测试客户端

test_client.py脚本测试所有工具、提示和资源：

python utils/test_client.py

大型语言模型示例客户端

llm_example_client.py脚本演示大型语言模型（如Claude）如何与Climatiq MCP服务器交互：

python utils/llm_example_client.py

关键特性：

  • 完整的API封装，包括错误处理和超时管理
  • 资源和结果缓存，保存计算历史
  • 示例提示展示如何生成自然语言解释
  • 展示了电力排放、旅行排放和排放因子搜索能力

命令行工具

一个命令行接口工具，用于直接访问API而不涉及MCP服务器的复杂性：

# 对于电力排放
python utils/climatiq_cli.py electricity --energy 1000 --unit kWh --region US

# 对于旅行排放
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. 验证API密钥在您的Climatiq仪表板中处于激活状态
  3. 使用examples/simple_test.py检查您的API密钥是否正常工作

高级用法

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

关于Climatiq

Climatiq提供了一个强大的API，用于碳智能，允许您计算来自电力使用、交通、采购等方面的排放。这个MCP服务器通过模型上下文协议使这些功能对AI助手可用。

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

许可证

本项目采用MIT许可证——详情见LICENSE文件。