Nasa Ads

@pipeworx/nasa-ads

NASA 天体物理数据系统——基本上涵盖了自 1823 年以来天文学与天体物理学的完整文献目录，并附有人工整理的引文和参考文献图谱。

属于 Pipeworx——一个将 AI agents 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• ads_search(query, sort?, limit?, start?, include_abstract?) — 使用完整的 ADS 查询语法检索文献（author:"Rubin, V"、year:2020-2024、bibstem:ApJ、abs:"phrase"、property:refereed）。
• ads_paper(identifier) — 按 bibcode、DOI 或 arXiv id 获取单篇论文的完整记录。系统会自动检测标识符类型并在相应字段中搜索，因此 DOI 绝不会悄然匹配到无关论文的全文。
• ads_citations(bibcode, direction?, sort?, limit?, start?) — 引用该论文的论文（citations，默认值）或该论文的参考文献（references）。

身份验证

仅支持自带密钥（BYO）。 传入 _apiKey。不支持无密钥调用：ADS 的每个端点都使用 Bearer 身份验证，未经身份验证的请求会直接返回 401 Missing "Authorization" in headers（已于 2026-09-17 验证）。拒绝消息会明确说明“需要 API 密钥”，避免调用方误以为我们的服务发生故障而看到 401。

令牌免费且额度充足：在 https://ui.adsabs.harvard.edu/ 创建账户，然后前往 Settings → API Token（https://ui.adsabs.harvard.edu/user/settings/token）。

平台备用方案：PLATFORM_ADS_TOKEN。在设置该密钥之前，包清单条目会携带 byoExpected: true；设置该值时，请在同一次更改中移除该标记。

数据源

• https://api.adsabs.harvard.edu/v1/search/query — 此处的每个工具都会调用该端点一次，只是 q 不同。ads_citations 使用 ADS 自带的 citations(bibcode:...) 和 references(bibcode:...) 运算符，而非单独的端点。

注意事项

• 实际上，fl 不是可选项。 省略它后，ADS 只会返回没有标题、作者或年份的裸 ID——这是一个看似正常的 200 响应，但结果集信息不完整。此处的每次调用都会显式传入字段列表。
• 不加引号的作者姓名会被当作全文检索。 author:Rubin 并不是作者搜索；author:"Rubin, V" 才是。全文匹配会返回看似合理但实际错误的论文，且不会报错，因此零结果提示会明确说明这一点。
• 年份范围格式为 year:2020-2024。 year>2020 是语法错误。
• bibcode 必须恰好为 19 个字符，并以点补齐（2015ApJ...808...50A）。如果复制时因换行重排而丢失补齐字符，就无法匹配任何结果，这与“该论文尚未编入索引”无法区分。
• 没有引用通常是正常情况。 对于最近几个月发表的论文，citations 结果为空很常见；未知 bibcode 也是如此。两种情况都会返回零条结果而不是错误，因此提示中会列出这两种原因。

快速开始

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

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

此端点实际提供的内容

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

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

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

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

两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出的工具属于哪个工具包；无论连接哪一个，ask_pipeworx 都能访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/ads_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"abs:\"dark energy\" property:refereed","sort":"citation_count desc","limit":20}'

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

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

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

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

或者直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-nasa-ads

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Nasa Ads data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT