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-serverAPI密钥配置
服务器需要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- 设置api密钥工具：使用
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
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.pyLLM示例客户端
这 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服务器支持多种计算方法：
- 基于距离的方法 旅行排放
- 高级旅行计算 具有起点-终点对
- 基于支出的方法 当你只有支出数据时
- 直接计算 使用特定排放因子
故障排除
API关键问题
- 确保
CLIMATIQ_API_KEY在您的环境或.env文件中设置正确 - 验证Climatiq仪表板中的API键是否处于活动状态
- 使用
examples/simple_test.py检查您的API密钥是否正常工作
高级用法
有关使用特定工具和高级功能的详细文档，请参阅 docs/README.md 文件。
关于Climatiq
Climatiq为碳智能提供了强大的API，允许您计算电力使用、运输、采购等方面的排放量。此MCP服务器通过模型上下文协议使AI助手可以访问这些功能。
有关Climatiq的更多信息，请访问 气候.io.
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
