Us National Archives

@pipeworx/us-national-archives

美国国家档案目录（NARA）——收录联邦政府各机构和总统图书馆永久记录的描述，并在有数字化页面图像时提供直接链接。

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

工具

• nara_search(query, limit?, page?, available_online?, level_of_description?, record_group_number?, include_digital_objects?) — 在目录中进行关键词搜索。
• nara_record(naid) — 获取一条完整记录及其档案层级。
• nara_digital_objects(naid, limit?) — 获取附加到记录的扫描件及其公有领域下载 URL。

身份验证

无需密钥。无需也不会使用 x-api-key — 详见下文。

数据源

• https://catalog.archives.gov/proxy/v3/records/search — 搜索和获取记录。

值得注意的事项：

• 文档中提到的 /api/v2/ 路径不会被路由。 每个 catalog.archives.gov/api/v2/... URL 都会返回目录的单页应用，内容类型为 text/html，状态码为 200，并且与刻意构造的无意义路径具有相同的 ETag，无论是否提供密钥都是如此。这不是服务中断，提供密钥也无法解决问题； 该路径根本没有提供服务。目录前端自身调用的端点是 /proxy/v3/records/search，且无需身份验证。
• /proxy/records/search（没有 v3）会拒绝大多数页面大小。 limit 为 1、10、 20、50、100 和 1000 时会返回 JSON；为 2、3、4、5、15 和 25 时会返回状态码为 200 的 SPA HTML。 每种情况都连续运行了三次，结果一致。/proxy/v3/records/search 接受任意 limit，因此本工具包只调用 v3 — 并且仍会在解析前检查内容类型，因为状态码为 200、实际却是 HTML，正是静默失败的典型情况。
• 分页参数是 page（从 1 开始）。 offset 和 from 会被忽略。
• 单条记录使用 naId_is=，而不是 naId=；后者用于逗号分隔的批量获取。
• NAID 在请求正文中是 JSON 数字，在参数中则是字符串。 只读取字符串形式会导致搜索结果中的所有 ID 变为空白，但不会报错。
• 负载是原始 Elasticsearch 数据：body.hits.total.value 和 body.hits.hits[]._source.record。

快速开始

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

{
  "mcpServers": {
    "us-national-archives": {
      "url": "https://gateway.pipeworx.io/us-national-archives/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/us-national-archives/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 都连接到同一个网关和相同的 1684+ 个数据源。唯一的区别是哪个工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都可以访问所有工具包。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/nara_search \
  -H 'Content-Type: application/json' \
  -d '{"query":"Apollo 11 moon","available_online":true,"limit":3}'

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

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

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

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

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

npx -y @pipeworx/mcp-us-national-archives

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Us National Archives data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT