CarbonMeld MCP 服务器
在 AI 助手中使用碳信用数据:通过高级版账户登录(或使用 API 密钥)连接您的助手或 MCP 客户端,进行项目搜索、查看评级、CORSIA 登记处标签与买家概况。
功能概览
通过模型上下文协议(MCP),让您的助手读取 CarbonMeld 项目记录和登记信息。MCP 处理程序不运行语言模型;返回数据由您自己的助手解读。它读取 CarbonMeld 记录,不签发、购买或转移碳信用。
工具
search_projects
输入: query、registry、country、methodology、sector、scoring_sector、developer、status、min_score、claim、sort、limit(1–25;默认10)、offset
按词语搜索(所有词语都须出现在项目名称、登记编号、国家、方法学或领域中),可按标准、国家、方法学、领域、评分领域(项目被评分时所属的领域,即排行榜的分组)、开发商、分析状态、评分和声明标签筛选,并可按评分或名称排序。返回匹配总数和其中一页结果(还有更多时给出 next_offset):标识符、国家及其ISO代码、方法学、领域、开发商、评分及其状态、日期和方法版本、登记状态、声明标签和项目链接。
get_project
输入: id(必填);lang、sections(可选)
按 slug 或登记编号获取已有完整项目记录,并附项目页面链接和文件链接(文件有自己的页面时附该页面链接)。其评级为方法论 v3 的基于文件的评级,附其区间和证据覆盖度;保留 v2.2 评分的页面给出该评分并加以标注;没有数值的页面说明原因。记录还包括负面事实、年份和声明;评分部分另附 v3 评级的详情(各维度的数值,以及适用的每条规则及其来源)。v2.2 分析的字段(各维度评分、风险指标、改进建议)作为来自 v2.2 分析的数据保留在记录中;采用 v3 评级的页面不显示这些字段。按方法论 v3 读取的页面不提供风险标志;保留 v2.2 评分的页面提供其风险标志,并标注 v2.2。答复还给出页面在记录之外给出的内容:页面上的提示、“本分析是如何完成的”、相似项目和 PDF 报告的地址。lang(en、zh、ja)给出该语言的译文;sections 只返回所请求的部分。高级版详情消耗共享的项目额度。
get_projects
输入: ids(必填;1–10 个 slug 或登记编号);lang、sections(可选)
一次调用获取多个项目记录:每个 id 返回与 get_project 相同的记录,按所给顺序排列;某个 id 失败时给出该 id 自己的错误。每返回一条记录即占用共享项目额度,与 get_project 完全相同。超出单次调用请求上限的 id 会以可重试状态返回且未被打开(不占用额度):请对这些 id 重新发起请求。
check_offer
输入: text(必填);vintage、quantity、seller(可选)
将粘贴的报价文本与记录中的登记、年份、数量、声明和开发商信息比较,不确认特定序列号的所有权或可用性。
corsia_supply
输入: lang(可选)
按网站所示,按登记处和阶段返回 CORSIA 登记处标签,以及评分最高的第一阶段项目和各登记处的平均评分,均取自项目当前的评分。余额为所有年份的未注销单位,并非符合 CORSIA 资格的单位。
get_buyer
输入: name(必填;公司名称或买家 slug);lang、limit(1–50;默认25)、offset(可选)
按 CarbonMeld 页面所示返回组织的公开注销记录:吨数、注销次数、所注销项目的质量、其项目(每个项目附注销吨数和项目当前的评分)以及最近的注销。注销受益方不一定是购买方;名称有歧义时需进一步确认。
get_methodology
输入: code(必填);lang(可选)
按 CarbonMeld 方法学页面的内容返回一个方法学:附来源的身份卡;方法论 v3 如何解读此类项目(在 v3 中不变的 v2.2 规则、已更改的规则及其变成的 v3 规则,以及指向 v2.2 原有规则的链接);版本历史和过渡;其项目(v3 评级的排名或列表);页面链接。
get_ranking
输入: dimension(必填:sector、country、standard、methodology);value、lang(可选)
按网站所示返回排行榜:某一维度的各个榜单及其数量和平均分,或某个榜单中按评分排序的项目(至少5个已评分),并附页面链接。领域榜单按项目被评分时所属的领域分组。
get_standard
输入: code(必填);lang(可选)
按 CarbonMeld 标准页面的内容返回一个标准:附来源的身份卡;方法论 v3 如何解读此标准的项目(在 v3 中不变的 v2.2 碳信用机制规则、已更改的规则及其变成的 v3 规则,以及指向 v2.2 原有规则的链接);其发布的方法学和其项目所用的方法学;其项目(v3 评级的排名或列表);页面链接。
get_developer
输入: name(必填;开发商名称或 slug);lang、limit(1–50;默认25)、offset(可选)
按 CarbonMeld 开发商页面的内容返回一个项目开发商:项目数、具有方法论 v3 评级的项目数和登记状态为被拒绝、已撤回、已终止、暂停或签发被拒的项目数、其标准和国家,以及按页面顺序排列的项目,每个项目附登记编号、国家、登记状态、评级或分析状态以及项目链接;评级按列表所示:方法论 v3 的评级及其区间、标注为 v2.2 的 v2.2 评分,或“评级为时尚早”/“暂无法评估”/“尚无适用的公开评定”/“暂不显示评级”,重新评估期间标为暂定。并附页面链接。没有公司层面的评级;名称有歧义时需进一步确认。
ccp_tracker
输入: status、program、methodology、lang(均为可选)
按网站所示返回 ICVCM CCP 追踪表:诚信委员会对方法学的评估及其状态和各状态的数量,以及每项评估中 CarbonMeld 以相同方法学代码追踪的该碳信用机制的项目数量(涵盖所有版本,并非 CCP 标签信用的数量)及其排行榜,并附表格来源和获取日期。
my_portfolio
输入: 无
按页面所示返回您自己的投资组合(我的投资组合):您保存的项目,每个项目附其评级(按列表所示:方法论 v3 的评级及其区间、标注为 v2.2 的 v2.2 评分,或“评级为时尚早”/“暂无法评估”/“尚无适用的公开评定”/“暂不显示评级”;重新评估期间标为暂定)、分析状态、登记状态、年份、在售数量和分析日期;按方法论 v3 读取的项目附其负面事实,保留 v2.2 评分的项目附其风险标志,并标注 v2.2;仅当所有已评级项目属于同一方法论版本时才给出各维度的数值;v3 评级的平均值;两个分开计算的数:按方法论 v3 读取的项目的负面事实总数和保留 v2.2 评分项目的风险标志总数;本周剩余修改次数;以及这些项目最近 30 天的变更提醒。仅限读取:保存和移除项目需在网站上进行。不占用每日项目额度。
what_changed
输入: view(all、notices、labels)、lang、limit(1–100;默认50)、offset(均可选)
返回 CarbonMeld 记录的最近30天的变化:规则制定机构的官方通知(ICVCM、Verra、Gold Standard、SBTi 等;发布机构、标题、链接、日期)以及项目的登记处标签的新增或移除(附各项目页面链接),以及整个窗口内每类标签变化涉及的项目数量。
get_method
输入: section、rule、dimension(每次只用其一;均为可选);lang、limit(1–50;默认25)、offset(可选)
按 /methodology/ 页面所示返回 CarbonMeld 的评级方法:方法论 v3,基于文件的评级。不带参数时:页面的各部分、方法论版本、四个维度及其权重,以及已存档的 v2.2 规则的地址。某一部分:页面上的文字,附其中的规则编号,每张规则卡片一行。按编号(A-START、Q-FNRB-ABOVE)或规则卡片的键返回一条规则:名称、作用、每项效果及其幅度、适用起始时间、来源及来源原文。v2.2 的编号(CM-…)返回该规则在 v2.2 中的内容及其在 v3 中的情况:不变、已更改(附其变成的 v3 规则)或已删除。某一维度(additionality、quantification、permanence、claim_safety、overall):作用于该维度的规则,分页返回(limit、offset;还有更多时给出 next_offset)。方法论 v3 没有 criterion。
search_articles
输入: query、tag、from、to(YYYY-MM-DD)、sort(newest、oldest)、lang、limit(1–50;默认10)、offset(均为可选)
按网站文章索引所示搜索 CarbonMeld 的英文、中文或日文文章:按词语(每个词语都须出现在标题、摘要或主题中)、按主题(网站该主题页面上的文章)和按日期。返回匹配总数和其中一页结果,按从新到旧或从旧到新排序(还有更多时给出 next_offset):标题、日期、摘要、主题、分类和链接。没有匹配时返回空列表,而不是错误。
search_projects 的 claim 可选值:corsia、corsia_first、ccp、ccp_meth、removal、article6。标签反映 CarbonMeld 持有的记录。
通过登录连接
Claude、ChatGPT、Claude Code、Cursor、VS Code 和 Microsoft 365 Copilot 代理可以通过登录连接 CarbonMeld,无需粘贴密钥。您在 CarbonMeld 页面上批准连接后,助手即可在与 API 相同的每日限额内读取您的高级版数据。仅限读取:它不能更改任何内容,也不能付款。您连接的所有助手共享同一个每日请求限额。
服务器 URL
https://carbonmeld.com/api/v1/mcp GitHub 上的配置示例和 MCP Registry 条目
在官方 MCP Registry 中的名称:com.carbonmeld/carbonmeld。
Claude(网页版、桌面和移动应用)
- 打开「Customize → Connectors」(claude.ai/customize/connectors),选择「+ Add」,然后选择「Add custom connector」。
- 名称:CarbonMeld。服务器 URL:https://carbonmeld.com/api/v1/mcp。选择「Continue」。
- 认证:「Sign in now」(或「Sign in when needed」)。OAuth client:「Register automatically」。
- 选择「Add」。CarbonMeld 页面将打开:通过电子邮件链接登录(请在同一浏览器中打开),然后批准。
- 在对话中,通过「+ → Connectors」开启 CarbonMeld。
如改用 API 密钥:在第 3 步选择「No sign in」,然后在「Request headers」下添加 Authorization,值为 Bearer 加上您的密钥。
Team 和 Enterprise 套餐:由 Claude 组织的 Owner 在「Organization settings → Connectors → Add → Custom → Web」中添加该连接器,之后每位成员用自己的账户登录进行连接。CarbonMeld 也已列入 Claude 的连接器目录。
ChatGPT
- 前往 chatgpt.com/plugins。
- 选择「+」按钮,然后选择「Add custom MCP server」。
- 输入名称(CarbonMeld)和说明。
- 在「Connection」下输入服务器 URL https://carbonmeld.com/api/v1/mcp。
- 认证方式选择 OAuth:ChatGPT 会自行在 CarbonMeld 注册,因此无需客户端 ID 或客户端密钥。阅读风险警告后,选择「I understand and want to continue」。
- 选择「Create as a plugin」,核对其列出的工具,然后安装。
- 在打开的 CarbonMeld 页面上登录,然后批准。在新对话中输入 @ 并选择 CarbonMeld。
添加和使用自定义 MCP 服务器须遵守账户和工作区的政策。
Claude Code
claude mcp add --transport http carbonmeld https://carbonmeld.com/api/v1/mcp 添加服务器后,在 Claude Code 中运行 /mcp 并选择进行认证,或在终端中运行 claude mcp login carbonmeld:CarbonMeld 页面将在浏览器中打开,登录后批准。如果批准后浏览器显示连接错误,请将地址栏中的完整地址粘贴到 Claude Code 显示的输入提示中。加上 --scope user 即可在您的所有代码项目中使用该服务器。
如改用 API 密钥,请添加请求头。如要在代码项目中共享设置而不提交密钥,请使用从环境变量 CARBONMELD_API_KEY 读取密钥的 .mcp.json:
claude mcp add --transport http carbonmeld https://carbonmeld.com/api/v1/mcp \
--header "Authorization: Bearer cmk_YOUR_KEY_HERE" {
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${CARBONMELD_API_KEY}"
}
}
}
} Cursor
{
"mcpServers": {
"carbonmeld": {
"url": "https://carbonmeld.com/api/v1/mcp"
}
}
} 将服务器添加到 ~/.cursor/mcp.json(所有代码项目)或 .cursor/mcp.json(单个代码项目)。Cursor 会要求您登录该服务器:CarbonMeld 页面将打开,登录后批准。Cursor 网页版和 Cursor Agents 同样可以登录 CarbonMeld。
如改用 API 密钥,请添加请求头,并在启动 Cursor 的环境中设置 CARBONMELD_API_KEY:
{
"mcpServers": {
"carbonmeld": {
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${env:CARBONMELD_API_KEY}"
}
}
}
} VS Code(GitHub Copilot)
- 在命令面板中运行「MCP: Add Server」。
- 选择「HTTP (HTTP or Server-Sent Events)」,输入 https://carbonmeld.com/api/v1/mcp。
- 输入服务器 ID carbonmeld,然后选择「Global」。
- 服务器启动时,VS Code 会要求您登录:浏览器将打开 CarbonMeld 页面,登录后批准。
由此写入的条目,位于可移植文件 ~/.copilot/mcp-config.json 中:
{
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp"
}
}
} 如改用 API 密钥,请添加从环境中读取密钥的请求头(可移植文件读取环境变量,不支持输入提示),并在启动 VS Code 的环境中设置 CARBONMELD_API_KEY。切勿将密钥粘贴到对话中,也不要将其提交到代码项目中。
{
"mcpServers": {
"carbonmeld": {
"type": "http",
"url": "https://carbonmeld.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer ${CARBONMELD_API_KEY}"
}
}
}
} Microsoft 365 Copilot(声明性代理)
Microsoft 365 Copilot 没有添加服务器的入口:CarbonMeld 作为声明性代理的插件接入,该代理用 Microsoft 365 Agents Toolkit(VS Code 扩展,6.12.0 或更高版本)构建。您的 Microsoft 365 账户需要启用自定义应用上传和 Copilot 访问;如未启用,请联系管理员。此流程不提供 API 密钥选项。
- 在 VS Code 中打开 Microsoft 365 Agents Toolkit →「Create a New Agent/App」→「Declarative Agent」。
- 「Add an Action」→「Start with an MCP Server」→ 输入 https://carbonmeld.com/api/v1/mcp。
- 认证类型:「OAuth (with dynamic registration)」:无需客户端 ID 或客户端密钥。
- 为代理选择位置和名称。
- 在「Accounts」中登录 Microsoft 365;在「Lifecycle」中选择「Provision」。
- 打开 m365.cloud.microsoft/chat,在「Agents」下选择该代理,然后询问某个项目。出现提示时,选择登录该代理:CarbonMeld 页面将打开,登录后批准。
Le Chat(Mistral):暂不支持。
要断开某个助手,请打开账户页面:「已连接的助手」列出每个助手及其「断开连接」按钮。断开后立即生效;您的 API 密钥不受影响。
或使用 API 密钥连接
任何支持设置远程服务器 URL 和静态 Authorization 请求头的 MCP 客户端,都可以用 API 密钥代替登录。各客户端界面不同;上方各客户端的部分说明了请求头的位置。
- 拥有有效的高级版访问权限时,在账户页面生成密钥。
- 设置下方远程服务器 URL,并添加包含您自己密钥的 Authorization 请求头。
- 连接后让客户端列出工具,再让助手先搜索项目,然后打开其完整记录。
连接设置
https://carbonmeld.com/api/v1/mcp
Authorization: Bearer cmk_YOUR_KEY_HERE 请勿将密钥放入共享文件:上方的 JSON 设置从环境变量 CARBONMELD_API_KEY 读取密钥。切勿将密钥粘贴到对话中,也不要将其提交到代码项目中。
传输方式:通过 HTTP POST 发送 JSON-RPC 2.0,返回 JSON。使用 GET 打开服务器 URL 会返回405;该地址不是网页。
协议版本: 2025-06-18
示例:列出工具
curl 'https://carbonmeld.com/api/v1/mcp' \
-H 'Authorization: Bearer cmk_YOUR_KEY_HERE' \
-H 'Content-Type: application/json' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' 在 Code Mode 中使用 CarbonMeld
一些 MCP 客户端(例如 Cloudflare 的 Code Mode / Agents SDK)会把服务器的工具转换为带类型的 TypeScript API,让模型编写调用这些工具的代码,而不是一次只调用一个工具。CarbonMeld 为每个工具声明了输出 schema,每个成功的结果都同时以 structuredContent 和 JSON 文本返回,因此这类客户端的每次调用都有精确的类型。
TypeScript 类型声明(.d.ts),由工具 schema 和 OpenAPI 文档生成: https://carbonmeld.com/api/v1/carbonmeld.d.ts
示例:查找肯尼亚基于文件的评级为 5 或以上的炉灶(cookstoves)项目,一次批量获取前 3 个,并列出每个项目的评级、区间、证据覆盖度、提高和降低其评级的规则数量,以及其负面事实。
// Cookstove projects in Kenya with a document-based rating of 5 or more, best first — search (free), then open the top 3
const found = await carbonmeld.search_projects({ sector: "cookstoves", country: "KE", min_score: 5, sort: "rating_desc", limit: 10 });
const batch = await carbonmeld.get_projects({ ids: found.results.slice(0, 3).map((p) => p.id), sections: ["score"] });
// each project not yet opened today counts 1 of the daily 30 — batch.quota says what is left
for (const item of batch.results) {
if (!item.ok) continue; // item.error says why this id gave no record (retryable: ask again for it)
const r = item.project.carbonmeld_rating, d = item.project.doc_rating;
// the rating, its band and evidence coverage; how many rules raised / lowered it; its negative facts (often none)
console.log(item.project.project_name, r.rating, r.rating_band, r.evidence_coverage, d.moves, d.negative);
} 额度计算:get_projects 每返回一条项目记录,就与 get_project 一样占用每日项目额度中的一个项目——10 条的批量最多占用 10 个。当天尚未打开的每个项目占用每日项目额度(高级版 30 个,Pro 300 个)中的 1 个,因此请先搜索(search_projects 免费),只打开用户需要的项目;当天已打开、已拥有或获赠的项目计 0。search_projects 和各页面工具不占用项目额度;每次工具调用都计入每日请求次数上限。
额度与合理使用
- 300 次请求/天/密钥,为默认上限,由 REST 与 MCP 共享。
- 30 个不同高级版项目/天,由网站、PDF 报告、REST 与 MCP 共享。同一天重复打开同一项目只计一次。投资组合中的项目及为您解锁的项目不占此额度;仅返回公开记录也不消耗项目额度。
- Pro:每个密钥每天 1,000 次请求,每天 300 个不同的项目;其他与上述相同。
- 20 次报价核查/天/账户,与网站报价核查共享。
每日计数在 UTC 00:00 重置。另外,每个 IP 每分钟最多120次请求。列表和统计请求计入请求次数,但不消耗高级版项目额度。
get_project 和 get_projects 与 REST API 共享高级版项目额度(get_projects 按返回的每条记录计一个项目)。工具调用计入每日请求次数上限;连接、列出工具及其他协议消息不计入(它们另有一个高得多的上限)。
认证和频率错误通过 HTTP 状态码返回。即使 HTTP 请求成功,工具结果也可能包含 isError: true,请检查结果内容。临时数据错误不是负面结论,请稍后重试。
数据与隐私
客户端会将工具参数(包括您粘贴的报价文本)发送给 CarbonMeld,返回记录则交给客户端,由您的助手进行推理。请仅提供核查所需信息,并检查客户端的数据设置。CarbonMeld 记录高级版功能使用和高级版项目访问。
与 REST API 使用相同密钥
直接 HTTP 请求、列表参数及错误码请参阅 REST 指南。
API 指南