Esa Gaia

@pipeworx/esa-gaia

ESA Gaia DR3 — 通过 ESA 档案库的 TAP 服务查询 18 亿颗恒星的位置、视差（由此推算距离）、自行、测光数据和天体物理参数。

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

工具

• gaia_cone_search(ra, dec, radius_arcmin?, max_magnitude?, min_parallax_mas?, limit?) — 查询天空某个位置周围指定半径内的所有恒星，按距离由近到远排列，并提供根据视差推算的距离。
• gaia_source_by_id(source_id) — 查询一颗恒星完整的天体测量和测光记录。
• gaia_adql_query(query, limit?) — 对档案库执行任意只读 ADQL SELECT 查询，最多返回 2,000 行。

身份验证

无需密钥 — 同步 TAP 端点不需要账号。

数据源

• https://gea.esac.esa.int/tap-server/tap/sync — IVOA TAP、ADQL、FORMAT=json。 主表为 gaiadr3.gaia_source。

否则接手的人迟早会重新发现的事项

• TAP 对被拒绝的查询仍会返回 HTTP 200，并在 VOTable 的 <INFO> 元素中附带错误，因此不加判断的调用方会把失败当作空结果。没有 data 数组的 JSON 响应体会被视为错误，并显示 <INFO> 文本。
• 视差以毫角秒为单位，也可能为负值。 它是带噪声的测量值，并非距离：大约五分之一的暗弱天体视差为负值。只有视差为正且测量可靠时，1000/parallax 才是以秒差距为单位的距离，因此视差为负或信噪比低于 5 时，distance_pc 为 null，并附带说明原因的 distance_note。即使如此仍进行倒数运算，会得到一个看似可信、实际毫无意义的数值。
• source_id 是 64 位整数。 响应体经过解析后，JSON.parse 已无法保留大于 2^53 的数值精度，因此输出时会将 ID 重新表示为字符串，输入时也接受字符串。
• source_id 值因数据发布版本而异 — DR2 的 ID 无法在 DR3 中解析。
• 匿名同步端点最多返回 2,000 行，且会静默截断超出部分的 TOP 查询结果，因此这里会显式应用上限，而不是依赖服务器。
• Gaia 的数据非常密集。 银道面上 1 度锥区内可能有数百万颗恒星；因此 radius_arcmin 默认为 3，且上限为 60。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/esa-gaia/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+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/gaia_cone_search \
  -H 'Content-Type: application/json' \
  -d '{"ra":56.75,"dec":24.1167,"radius_arcmin":3,"max_magnitude":15,"limit":5}'

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

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

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

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

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

npx -y @pipeworx/mcp-esa-gaia

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Esa Gaia data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT