Faostat

@pipeworx/faostat

联合国粮食及农业组织统计数据——涵盖自 1961 年以来 245 个国家和地区的农作物及畜牧业生产、食物平衡表、农业贸易、土地和投入品使用、农场排放、粮食安全及生产者价格。

属于 Pipeworx 的一部分——连接 AI Agent 与 1879+ 个实时数据源的 MCP 网关。这是一个独立、非官方的集成，与上游提供方无关联、未获其认可，也非其发布。

工具

• faostat_domains(search?, domain_code?, limit?) — 69 个统计领域， 包含最后更新日期和观测数量。可获取领域代码。
• faostat_dimensions(domain_code, dimension, search?, limit?) — 领域的有效 area / element / item / year 代码。请在调用下一个工具前先调用此工具。
• faostat_data(domain_code, area?, element?, item?, year?, limit?) — 观测数据， 包含单位、年份和数据质量标记。

身份验证

无需密钥。

数据来源

• https://bulks-faostat.fao.org/production/datasets_E.json — 领域目录。包含查询 API 不提供的 DateUpdate 和 FileRows。
• https://fenixservices.fao.org/faostat/api/v1/en/definitions/domain/{domain}/{dimension} — 维度代码列表。
• https://fenixservices.fao.org/faostat/api/v1/en/data/{domain} — 观测数据。

值得了解的事项：

• 有两个主机，且故障彼此独立。 在构建此工具包期间，截至 2026-09-17 22:00–23:00 UTC，fenixservices（查询 API）的所有路径均返回 Cloudflare 521， 随后发生超时；bulks-faostat 始终未受影响。工具包会将其显示为明确标注的上游服务故障—— 如果这里返回空数组，会被理解为“这个国家什么都不种”。
• faostatservices.fao.org 是不同的主机，响应为 401 Missing Authorization Header。它不能直接替代前者。
• bulks-faostat.fao.org 提供目录 JSON，但访问按领域划分的路径时会返回 403， 例如 /production/QCL/QCL_AreaCodes_E.json；只有文档中列出的目录和 ZIP 批量文件可读取。
• FAOSTAT 代码是数字且按领域区分的。错误的 item 代码会返回空结果，而非错误； 因此才有 faostat_dimensions，并且 faostat_data 会在零行结果中明确说明这一点。
• 这不是 codex-mrl 工具包——该工具包也读取 fao.org，但提供的是《食品法典》最高残留限量。

已验证

2026-09-17 — faostat_domains 返回了全部 69 个领域，以及更新日期和行数。 faostat_dimensions 和 faostat_data 未能验证：整个构建时段内，FAO 查询主机都处于宕机状态（见上文）。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "faostat": {
      "url": "https://gateway.pipeworx.io/faostat/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/faostat/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自己的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，也是某一天的权威答案。

这是有意为之，并非意外的多路复用。元工具让限定范围的连接也能回答此工具包未涵盖的问题——通过可跨整个目录路由的 ask_pipeworx，无需再添加第二个 MCP 服务。目前无法挂载不带这些元工具的工具包端点；如果额外的架构定义带来的上下文开销超过路由的价值，请连接完整网关一次，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1879+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；通过任一 URL，ask_pipeworx 都能访问所有工具包的工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/faostat_domains \
  -H 'Content-Type: application/json' \
  -d '{"search":"production"}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/faostat_domains。查找工具包：使用 {"query":"..."} 发送 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关往返调用：

{
  "mcpServers": {
    "faostat": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-faostat"]
    }
  }
}

或者直接运行它，确认其能够启动：

npx -y @pipeworx/mcp-faostat

它通过 stdin/stdout 使用 MCP 协议，并对 initialize/tools/list/tools/call 作出响应，且仅包含此工具包的工具——不包含上述网关连接额外提供的共享元工具。来源相同，工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用简单的英文提问，而不必直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Faostat data" })

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT