Nih Supplements

@pipeworx/nih-supplements

NIH 关于维生素、矿物质和少数植物药的情况说明书，涵盖用途、安全性、与药物的相互作用和参考资料；还提供来自 NIH 膳食补充剂标签数据库的真实补充剂产品标签，以及 NCCIH 对众多 ODS 未涵盖的热门草药所作的安全性与科学性概要。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

• supplement_factsheet(name, level?) — 某主题的 ODS 情况说明书：功效、是否有效、安全性和与药物的相互作用。 level 为 consumer（简短，默认）或 professional（较长、偏临床，并附有参考资料列表）。
• supplement_factsheets(query?) — ODS 发布情况说明书的约 45 个主题列表，以及各主题提供的阅读级别。
• supplement_labels(query, limit?) — 按产品、品牌或成分搜索膳食补充剂标签数据库（DSLD）中的真实产品标签（品牌、成分、含量、声称）。
• supplement_label(id) — 某款产品的完整标签详情：成分含量、其他成分、制造商联系方式和注意事项声明。
• herb_at_a_glance(herb) — NCCIH 的“草药一览”科学与安全概要，涵盖约 56 种热门草药（姜黄、银杏、紫锥菊、大蒜、人参、水飞蓟、圣约翰草等），这些草药没有 ODS 自己的情况说明书。
• supplement_recent_changes(since, limit?) — 在指定日期当天或之后新增的 DSLD 产品标签，按最新到最旧排序；重放结果具有确定性。DSLD 是 NIH 唯一提供可查询变更信号的补充剂上游数据源；响应会明确说明，上游无法对下架状态变更（offMarket transitions）以及 ODS/NCCIH 内容更新进行差异比较，而不会假装能够覆盖这些变更。

变更追踪与枚举（用于定期刷新）

• 新标签： supplement_recent_changes(since) 会按最新到最旧的顺序翻页查询 DSLD（sort_by=entryDate&sort_order=desc），直到达到截止时间——结果具有确定性，因此在 NIH 新增标签之前，重放操作具有幂等性。
• 情况说明书／草药页面的内容变更： 上游无法进行差异比较——没有列表端点，也没有 sitemap lastmod（已于 2026-09-08 检查；NCCIH 的 sitemap 存在，但不含日期；HHS 的联合 API 则被机器人访问限制拦截）。 每个 supplement_factsheet 响应都会附带自身的 reviewed 日期。
• 完整枚举： 两类内容库都已打包，且规模较小——supplement_factsheets() 列出全部约 45 个 ODS 主题；约 56 种 NCCIH 草药位于 src/index.ts 中的 NCCIH_HERBS（且可以完整获取任一列表中的名称）。可通过相同的排序翻页方式（size/from）枚举 DSLD 的完整内容库（约 215k 个标签）；NIH 还在 https://dsld.od.nih.gov/ 发布完整的 DSLD 数据集，供批量使用。情况说明书没有带版本号的批量文件——对已打包的目录进行枚举就是获取其快照的方式。

身份验证

无需密钥。三个上游数据源（ODS 情况说明书、DSLD、NCCIH）都是无需 API 密钥即可访问的 NIH 开放网站。

数据源

• https://ods.od.nih.gov/api/ — ODS 资料页 XML API （?resourcename=<slug>&readinglevel=Consumer|HealthProfessional&outputformat=XML）。 **注意：**使用浏览器特征的 User-Agent 发起首次调用会返回真实 XML；同一客户端快速发起第二次调用时，会返回 HTTP 200，但内容是 HTML 机器人检查页面，而非数据——状态码相同，没有错误，但响应内容完全不同。切勿将此主机返回的 HTML 格式 200 响应误认为“未找到”；这表示“放慢速度并重试”。本项目通过每个隔离实例的缓存，以及限制出站调用的最小间隔（src/index.ts 中的 spacedFetch/MIN_GAP_MS）来处理此情况——如果要修改此文件，请勿移除该机制。
• https://ods.od.nih.gov/factsheets/list-all/ — 没有实时接口可以列出所有资料页（显而易见的接口会返回 403；站点地图也不包含资料页 URL），因此约 45 个主题的清单（src/index.ts 中的 ODS_TOPICS）是根据此页面于 2026-09-07 手动整理并打包的。几乎所有主题在两个阅读级别下都使用相同的 slug——级别由单独的查询参数指定——但有两个例外：“Dietary Supplements in the Time of COVID-19”和 Chromium 在不同级别下使用不同的 slug，因此清单为每个主题分别保存 consumerSlug/professionalSlug，而不是使用一个共享 slug。
• https://api.ods.od.nih.gov/dsld/v9/search-filter?q= — DSLD 标签搜索，无需密钥的 JSON。hit._source 包含 brandName、fullName、productType、allIngredients、claims、netContents、offMarket。
• <https://api.ods.od.nih.gov/dsld/v9/label/> — DSLD 标签详情（没有在任何可查找的地方记录；于 2026-09-07 通过比对搜索 API 的 _id 字段发现）。包含成分用量（ingredientRows[].quantity[]）、其他成分、制造商联系信息，以及印在瓶身上的注意事项和警告声明。
• <https://www.nccih.nih.gov/health/> — NCCIH 的“草药速览”页面。未发现 JSON-LD、__NEXT_DATA__ 或 XHR/API（于 2026-09-07 检查），但每个页面的内容 <h2> 都带有稳定的 id 属性——background、how-much-do-we-know、what-have-we-learned、what-do-we-know-about-safety、keep-in-mind、for-more-information、key-references——已确认 5 种草药（南非醉茄、紫锥菊、大蒜、银杏、姜黄）的标识完全相同且顺序一致。这满足了在这些页面上构建受限文本提取器所要求的“章节稳定”条件（docs/herbal-sources-scope.md §2），因此已发布 herb_at_a_glance。约 56 种草药的清单（NCCIH_HERBS）也同样根据 nccih.nih.gov/health/herbsataglance 于 2026-09-07 手动整理并打包——这里也没有实时索引。
• German Commission E（herbalgram.org 上的 ABC 英文译本）未纳入——这是 1998/2000 年的版权作品，页面上没有任何再利用条款。如需使用，请链接到该 URL；不要抓取或镜像其文本。

快速开始

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

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

此端点实际提供的内容

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

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

curl -X POST https://gateway.pipeworx.io/v1/tools/supplement_factsheet \
  -H 'Content-Type: application/json' \
  -d '{"name":"Ashwagandha","level":"consumer"}'

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

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

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

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

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

npx -y @pipeworx/mcp-nih-supplements

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

使用 ask_pipeworx

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

ask_pipeworx({ question: "your question about Nih Supplements data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT