CarbonMeld MCP 服务器
使用高级版 API 密钥连接 MCP 客户端:项目搜索、完整记录、报价核查、CORSIA 供应与买家概况。
功能概览
通过模型上下文协议(MCP),让您的助手读取 CarbonMeld 项目记录和登记信息。MCP 处理程序不运行语言模型;返回数据由您自己的助手解读。它读取 CarbonMeld 记录,不签发、购买或转移碳信用。
五个工具
search_projects
输入: query、registry、min_score、claim、limit(1–25;默认10)
按项目名称中的词语或登记编号搜索,可按标准、评分和声明标签筛选。返回标识符、国家、评分、登记状态、声明标签和项目链接。
get_project
输入: id(必填)
按 slug 或登记编号获取已有完整项目记录,包括分析、风险提示、年份和声明。高级版详情消耗共享的项目额度。
check_offer
输入: text(必填);vintage、quantity、seller(可选)
将粘贴的报价文本与记录中的登记、年份、数量、声明和开发商信息比较,不确认特定序列号的所有权或可用性。
corsia_supply
输入: 无
基于登记标签,按登记机构和阶段返回 CORSIA 供应数据,以及评分最高的第一阶段项目。
get_buyer
输入: name(必填;公司名称或买家 slug)
组织的公开注销记录:吨数、项目及其质量。注销受益方不一定是购买方;名称有歧义时需进一步确认。
search_projects 的 claim 可选值:corsia、corsia_first、ccp、ccp_meth、removal、article6。标签反映 CarbonMeld 持有的记录。
连接客户端
请使用支持设置远程服务器 URL 和静态 Authorization 请求头的 MCP 客户端。各客户端界面不同;本指南不承诺与特定应用兼容。
- 持有效通行证,在账户栏生成密钥。
- 设置下方远程服务器 URL,并添加包含您自己密钥的 Authorization 请求头。
- 连接后让客户端列出工具,再让助手先搜索项目,然后打开其完整记录。
连接设置
https://carbonmeld.com/api/v1/mcp
Authorization: Bearer cmk_YOUR_KEY_HERE 传输方式:通过 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"}' 额度与合理使用
- 300 次请求/天/密钥,为默认上限,由 REST 与 MCP 共享。
- 30 个不同高级版项目/天,由网站、PDF 报告、REST 与 MCP 共享。同一天重复打开同一项目只计一次。投资组合中的项目及为您解锁的项目不占此额度;仅返回公开记录也不消耗项目额度。
- 20 次报价核查/天/账户,与网站报价核查共享。
每日计数在 UTC 00:00 重置。另外,每个 IP 每分钟最多120次请求。列表和统计请求计入请求次数,但不消耗高级版项目额度。
get_project 与 REST API 共享高级版项目额度。MCP 连接及工具请求也受 API 请求次数限制。
认证和频率错误通过 HTTP 状态码返回。即使 HTTP 请求成功,工具结果也可能包含 isError: true,请检查结果内容。临时数据错误不是负面结论,请稍后重试。
数据与隐私
客户端会将工具参数(包括您粘贴的报价文本)发送给 CarbonMeld,返回记录则交给客户端,由您的助手进行推理。请仅提供核查所需信息,并检查客户端的数据设置。CarbonMeld 记录通行证功能使用和高级版项目访问。
与 REST API 使用相同密钥
直接 HTTP 请求、列表参数及错误码请参阅 REST 指南。
API 指南