Kyrodata — Brazil Trade, Crop & Commodity Data

Kyrodata 是一个远程模型上下文协议服务。 无需安装或运行任何内容：让你的 Agent 连接托管端点，并提供你的 API 密钥即可。

https://mcp.kyrodata.com/mcp

用日常语言提问——“今年巴西的咖啡出口表现与去年相比如何？”——即可获得实际数据、涵盖的时间范围以及数据来源。

获取密钥

在 kyrodata.com/user/api-keys 创建密钥。密钥仅显示一次。查询会消耗套餐中已包含的额度——连接器不需要单独订阅。

连接

任何支持请求头的 Agent（Cline、Claude Code、Cursor、VS Code、Codex、n8n、Zapier、Make）：

{
  "mcpServers": {
    "kyrodata": {
      "url": "https://mcp.kyrodata.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_KYRODATA_API_KEY" }
    }
  }
}

命令行用法：

claude mcp add --transport http kyrodata https://mcp.kyrodata.com/mcp \
  --header "Authorization: Bearer $KYRODATA_API_KEY"

codex mcp add kyrodata --url https://mcp.kyrodata.com/mcp \
  --bearer-token-env-var KYRODATA_API_KEY

gemini mcp add --transport http --header "Authorization: Bearer $KYRODATA_API_KEY" \
  kyrodata https://mcp.kyrodata.com/mcp

聊天助手（claude.ai、ChatGPT）没有填写密钥的字段——它们会改为请求你的授权。将 Kyrodata 添加为自定义连接器，使用相同的 URL，并在提示时登录。各客户端的操作指南：kyrodata.com/developers。

可获取的数据

提供只读工具，涵盖巴西对外贸易（MDIC/ComexStat）、农作物生产、供需平衡表、气候读数和大宗商品预测。

工具	可回答的问题
kyrodata_search	搜索公开贸易目录
kyrodata_fetch	按 ID 打开一份公开贸易文档
kyrodata_resolve_entity	解析国家、HS 编码或大宗商品
kyrodata_compare_trade	比较相同时段内的出口/进口
kyrodata_list_trade_series	以行形式返回原始月度贸易序列
kyrodata_list_trade_partners	列出增长率最高的贸易伙伴国
kyrodata_get_heading_overview	查看 HS 税目（SH4）概览
kyrodata_resolve_comparison_window	构建可直接比较的时间窗口
kyrodata_get_supply_demand_balance	供需平衡表
kyrodata_get_climate_reading	气候读数和农作物实际损失
kyrodata_get_hub_summary †	大宗商品中心摘要和预测结论
kyrodata_explain_pyramid_level †	解释预测金字塔中的一个层级
kyrodata_run_report	运行一份目录报告
kyrodata_get_data_coverage	数据覆盖范围和最近一个已结算月份
kyrodata_get_credit_balance	此密钥的额度余额和限额（免费）

实时端点上的 tools/list 是权威列表。

† 两个价格预测工具属于额外套餐。贸易、气候和供需工具不需要额外套餐。

它如何作答

• 窗口从设计上就是等权的。 绝不会将三个月与整整一年进行比较；服务会拒绝不等长的窗口，并返回带有标注的最大匹配窗口。
• 每个回答都会注明窗口和数据来源。
• “无信号”也是有效回答，适用于数据不足以得出结论的情况。
• 只读。 没有任何工具会写入、删除或购买任何内容。

将其作为本地命令运行（你几乎肯定不该这样做）

bridge/server.py 是一个从标准输入输出转发到 HTTP 的转发器，Dockerfile 会将其打包。这不是服务本身。 服务位于远程，任何支持远程 MCP 的客户端都应直接连接到上面的 URL——少一跳，也无需安装任何内容。此转发器只适用于两种情况：客户端只能启动本地命令；以及目录不会为无法构建、启动和自省的项目评分。

docker build -t kyrodata-mcp .
docker run -i --rm -e KYRODATA_API_KEY=kd_live_... kyrodata-mcp

它不实现自己的任何工具：initialize、tools/list 和 tools/call 都会原样转发，因此这里没有另一份可能与服务不一致的工具目录。零第三方依赖，密钥也不会进入镜像。

说明

• 传输方式为 streamable-http。不提供已弃用的 HTTP+SSE 传输方式。
• 不提供凭据时，端点会返回 401，绝不会返回 403。
• 密钥应放在 Authorization 标头中。不接受查询字符串中的密钥，因为查询字符串会留在浏览器历史记录和代理日志中。

本仓库内容采用 MIT 许可。托管服务有自己的 条款。