Climatiq MCP Server

🚀 Climatiq MCP 服务器

一个 Model Context Protocol (MCP) 服务器，用于通过访问 Climatiq API 来计算碳排放量。借助该服务器，AI 助手能够实时进行碳排放计算并提供气候影响洞察。

🚀 快速开始

你可以通过以下链接查看演示视频：

• 请查看视频链接
• 请查看另一个视频链接

✨ 主要特性

工具

此服务器支持以下工具：

1. electricity (电力消耗)
   • 输入参数：energy, unit, region
   • 输出：电力供应的碳排放量
2. travel (旅行)
   • 支持的距离单位：公里 (km) 和 英里 (mi)
   • 支持的模式：car（汽车）、bus（公共汽车）、train（火车）
   • 输入参数：distance, unit, mode
3. emission-factor-search (排放因子搜索)
   • 找到与给定条件匹配的活动 ID

提示

提供以下提示以生成自然语言解释：

1. 概述碳排放计算
2. 详细描述碳排放来源
3. 提供减少碳足迹的建议

📦 安装指南

环境变量

设置以下环境变量或在代码中指定 API 密钥：

CLIMATIQ_API_KEY=your_api_key_here

安装

使用 pip 安装此包：

pip install climatiq-mcp-server

💻 使用示例

基础用法

电力消耗计算

from climatiq_mcp_server import ElectricityTool

tool = ElectricityTool()
result = tool.invoke(
    energy=1000,
    unit='kWh',
    region='US'
)
print(result)

旅行排放计算

from climatiq_mcp_server import TravelTool

tool = TravelTool()
result = tool.invoke(
    distance=100,
    unit='km',
    mode='car'
)
print(result)

🔧 技术细节

• 所有工具均支持异步调用和超时设置
• 提供详细的错误处理日志
• 支持结果缓存以提高性能

📚 详细文档

如需查看详细文档，请访问 docs/README.md

📄 许可证

本项目使用 MIT 许可证，具体内容请参考 LICENSE 文件。