Copernicus Dataspace

@pipeworx/copernicus-dataspace

来自欧盟 Copernicus Data Space Ecosystem 的 European Sentinel 和 Copernicus Contributing Mission 档案库——按区域和日期搜索 Sentinel-1/2/3/5P、Copernicus DEM、土地覆盖和烧毁区域产品，并获取项目 ID、覆盖范围、日期和产品资产路径。

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

工具

• copernicus_dataspace_collections(contains?, prefix?, limit?) — 产品集合及其许可证、范围和日期范围。请先调用此工具：搜索时若未指定集合，查询会被拒绝。
• copernicus_dataspace_collection(collection_id) — 获取某个集合的完整信息。
• copernicus_dataspace_search(collections, bbox?, datetime?, ids?, limit?, max_assets?) — 查询指定日期内覆盖某个区域的产品。

身份验证

目录搜索无需密钥。**但下载产品需要凭据：**资产 href 是 s3://eodata/... 对象存储路径，获取文件需要免费的 Copernicus 账户和 S3 或 OData 凭据（请在 https://dataspace.copernicus.eu 注册）。此处返回的 ID、日期、覆盖范围和资产清单信息完整，无需账户即可获取。

相关套件

sentinel-hub 套件是 商业版 Sentinel Hub 处理 API（OAuth 客户端凭据；提供返回计算结果的统计/NDVI 端点）。本套件是其底层的免费欧盟目录——它说明有哪些场景；Sentinel Hub 则负责渲染和分析。两者不能相互替代。

数据源

• https://catalogue.dataspace.copernicus.eu/stac — STAC API 1.0。该 API 会将其自身的 links 重定向到 https://stac.dataspace.copernicus.eu/v1；两个地址都可访问。

共享客户端：shared/src/stac.ts，planetary-computer、earth-search 和 meteoswiss 也会使用它。

注意事项

• 如果使用不包含 collections 的 POST /search，会返回 HTTP 400 CollectionInQuerryIsMissingError（保留上游原有拼写）。
• GET /collections 每次分页返回十条。 未分页读取一次会让目录看起来只有十个数据集——这不是报错，而是一个看似可信的错误答案。共享客户端会跟进 rel="next"。
• 资产 href 使用 s3://，而非 HTTPS。Agent 若将其当作下载 URL，就无法获取内容，并会误认为这是一个失效链接。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/copernicus-dataspace/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 都会访问同一个网关和相同的 1875+ 个数据源。唯一的区别在于直接列出哪个套件的工具；无论连接哪个 URL，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/copernicus_dataspace_collections \
  -H 'Content-Type: application/json' \
  -d '{"contains":"sentinel-2","limit":5}'

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

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

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

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

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-copernicus-dataspace

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

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——无论使用上方工具包端点还是完整网关，都可以这样操作：

ask_pipeworx({ question: "your question about Copernicus Dataspace data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT