Global Forest Watch

@pipeworx/global-forest-watch

全球森林观察（WRI / UMD）数据 API——GFW 背后的目录和查询接口，涵盖年度树木覆盖损失与增长、原始森林范围、GLAD 和 RADD 森林砍伐警报、VIIRS/MODIS 火灾警报、碳通量、保护区、特许经营区以及 Aqueduct 水资源风险。

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

工具

• gfw_datasets(query?, limit?, page?) — 列出目录或按关键词搜索 （截至 2026-09 共 382 个数据集）。指定 query 时会遍历整个目录， 最多访问上游 5 页。无需密钥。
• gfw_dataset(dataset, version?) — 获取单个数据集的元数据（来源、引用、 分辨率、覆盖范围、更新频率、注意事项、许可证）和版本列表； 指定版本时，还会返回该版本的状态、资源及字段/波段列表。 无需密钥。
• gfw_query(dataset, sql, version?, limit?, _apiKey) — 对单个数据集版本执行只读 SELECT。 需要调用方提供密钥。

身份验证

截至 2026-09-17，已确认目录浏览无需密钥。/query 端点需要 x-api-key，没有密钥时会返回 403 "Request is missing valid API key"。

目前未配置平台密钥。待密钥就绪后，预期使用的环境变量为 PLATFORM_GFW_KEY；请前往 https://globalforestwatch.org 注册，然后在数据 API 上调用 POST /auth/token，再调用 POST /auth/apikey 创建密钥。

密钥尚未配置，因此故意不声明 platformKeyEnv，原因与 copernicus-cds 相同——请参阅该 README 的身份验证部分。添加密钥的同时，也应在同一项更改中加入该变量。

数据源

• https://data-api.globalforestwatch.org/datasets — 目录。分页参数为 page[number] / page[size]（JSON:API 风格，使用方括号）；响应中包含 meta.total_items 和 meta.total_pages。
• https://data-api.globalforestwatch.org/dataset/{d} — 数据集元数据。
• https://data-api.globalforestwatch.org/dataset/{d}/{version} — 版本 元数据。latest 是有效的版本别名，但会 307 重定向到具体版本，因此请求必须跟随重定向。直接使用 curl 且不加 -L 时，会看到正文为空的 307 响应，容易误以为服务中断。
• https://data-api.globalforestwatch.org/dataset/{d}/{version}/fields — 列/波段。栅格数据集会在 pixel_meaning 而非 name 中提供列名。
• https://data-api.globalforestwatch.org/dataset/{d}/{version}/query — SQL。 表名始终为 data。

快速开始

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

{
  "mcpServers": {
    "global-forest-watch": {
      "url": "https://gateway.pipeworx.io/global-forest-watch/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/global-forest-watch/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/gfw_datasets \
  -H 'Content-Type: application/json' \
  -d '{"query":"tree cover loss","limit":5}'

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

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

此软件包也可以作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关：

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

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

npx -y @pipeworx/mcp-global-forest-watch

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，但仅提供此软件包的工具——不包含上述网关连接所添加的任何共享元工具。相同的源代码、相同的工具，不经过 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——这既适用于上述软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Global Forest Watch data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT