Climatiq MCP Server

🚀 Climatiq MCP 服务器

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

🚀 快速开始

本服务器可帮助你通过 Climatiq API 实现碳排放计算，让 AI 助手实时提供气候影响洞察。以下是快速开始的步骤：

1. 按照“安装和配置”部分的说明设置环境变量和安装包。
2. 参考“使用示例”部分的代码，调用相应工具进行碳排放计算。

✨ 主要特性

工具支持

此服务器支持以下工具：

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 文件。

🔍 演示

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