GreenCalculus MCP 服务器提供有来源依据的温室气体排放因子和可审计的碳计算，以 MCP 服务器形式对外服务。其核心特点是：每个返回值都带有精确的来源引用和固定的数据版本，因此智能体返回的数字既能被人引用，也能被机器复现，而不是一个猜测值。
用途与定位 该服务面向需要碳排放因子与碳计算能力的 AI 智能体场景，覆盖活动排放、隐含碳（EN 15978）以及 PCAF 融资排放等计算类型，并附带来源引用与数据版本。
主要能力
- 提供有来源的温室气体排放因子。
- 提供可审计追踪的碳计算。
- 每个值返回精确来源引用与固定数据版本。
- 支持发现类方法 initialize、tools/list，以及 search_factors、explain_absence 等工具。
使用方式 该服务器是远程的。如果客户端支持远程 MCP，应直接指向 URL，无需安装、无需更新。本仓库中的包是为只能启动本地 stdio 进程的客户端以及 docker run 安装场景而存在的，它是一个轻量桥接：把每条 JSON-RPC 消息转发到远程服务器并原样返回回复，不对任何方法做特殊处理，因此新工具无需发版即可在此出现。
通过 stdio 使用，或使用 Docker：镜像发布在 GitHub Container Registry，地址为 ghcr.io/greencalculus/greencalculus-mcp（支持 linux/amd64 和 arm64，标签为 latest 及每个版本）。使用 Docker 时必须加 -i 且不能加 -t，因为容器的 stdin/stdout 就是传输通道，TTY 会破坏数据流。
密钥与访问 可在 https://greencalculus.com/developers 获取免费密钥，无需信用卡。发现类方法（initialize、tools/list）无需密钥即可工作，search_factors 和 explain_absence 也无需密钥；其他所有工具都需要密钥。
诊断与输出 诊断信息写入 stderr。stdout 只写 JSON-RPC，任何多余字节都会破坏会话。
发布流程 在 package.json 中提升版本号并合并到 main 即可，npm、MCP 注册表和容器镜像都会随之更新。release.yml 会先询问 npm 和 MCP 注册表是否已有该版本，只发布缺失的地方，因此提升版本的合并会发布，未提升版本的合并则无操作。该工作流每周也会运行，失败的发布会自动重试而无需新提交。server.json 是注册表清单，工作流在发布前会从 package.json 重写其版本号，实现单一事实来源、三处保持一致。npm 通过可信发布认证，因此仓库中没有 npm token。注册表需要一个密钥，原因是：发布使用 com.greencalculus/api 这一 DNS 命名空间，而 GitHub OIDC 只授予 io.github.<org>/*，因此注册表步骤使用与 greencalculus.com 上 v=MCPv1 TXT 记录匹配的密钥签名，保存在 MCP_PRIVATE_KEY 中。scripts/rotate-registry-key.sh 可生成新密钥对并安装，且从不打印私钥部分，同时打印需要发布的 TXT 记录。若缺少该密钥，注册表步骤会跳过并说明，npm 仍会发布。
相关资源
- REST API 与文档：https://greencalculus.com/developers
- 客户端 SDK（Python、JS/TS）：https://github.com/greencalculus/greencalculus-sdk
- 官方 MCP 注册表：com.greencalculus/api
- Smithery：https://smithery.ai/servers/greencalculus/api
许可 MIT，见 LICENSE。该许可覆盖此桥接包。API 返回的排放因子数据遵循其底层来源的许可，每个响应中都会注明来源名称。
