Nih Supplements

@pipeworx/nih-supplements

ビタミン、ミネラルおよび一部の植物成分に関するNIHのファクトシート — 用途、安全性、医薬品との相互作用、参考文献 — に加え、NIHのDietary Supplement Label Databaseに登録された実際のサプリメント製品ラベル、さらにODSが独自には扱っていない多くの人気ハーブについて、NCCIHによる安全性と科学的知見の概要を提供します。

Pipeworx の一部です — AI エージェントを1683以上の稼働中のデータソースに接続するMCPゲートウェイです。

ツール

• supplement_factsheet(name, level?) — トピックに関するODSのファクトシートです。用途、効果の有無、安全性、医薬品との相互作用を確認できます。 level は consumer（短い、デフォルト）または professional（長く、臨床向けで、参考文献一覧付き）です。
• supplement_factsheets(query?) — ODSがファクトシートを公開している約45のトピックと、それぞれの閲覧レベルを一覧表示します。
• supplement_labels(query, limit?) — Dietary Supplement Label Database（DSLD）から、製品、ブランド、成分を指定して実際の製品ラベル（ブランド、成分、含有量、表示）を検索します。
• supplement_label(id) — 1製品のラベル詳細全体を表示します。成分の含有量、その他の成分、メーカーの連絡先、注意事項が含まれます。
• herb_at_a_glance(herb) — ODS独自のファクトシートがない約56種の人気ハーブ（ターメリック、イチョウ、エキナセア、ニンニク、朝鮮人参、ミルクシスル、セントジョーンズワートなど）について、NCCIHの「Herbs at a Glance」による科学的知見と安全性の概要を提供します。
• supplement_recent_changes(since, limit?) — 指定日以降に登録された新しいDSLD製品ラベルを、新しい順に返します。再実行時も結果が確定的です。DSLDは、変更を照会できるシグナルを備えた唯一のNIHサプリメント上流ソースです。レスポンスでは、取り下げ（offMarketへの遷移）とODS／NCCIHのコンテンツ更新は上流で差分を取得できないことを明記し、追跡できるかのように装うことはありません。

変更追跡と全件列挙（定期的な更新確認用）

• 新しいラベル： supplement_recent_changes(since) は、指定した基準日までDSLDを新しい順にページングします（sort_by=entryDate&sort_order=desc）。結果は確定的であるため、NIHが新しいラベルを登録しない限り、再実行しても冪等です。
• ファクトシート／ハーブページのコンテンツ変更： 上流では差分を取得できません。一覧エンドポイントも、lastmod のあるサイトマップもありません（2026-09-08確認済み。NCCIHのサイトマップは存在しますが日付情報はなく、HHSのシンジケーションAPIはボットによってアクセスを制限されています）。 各 supplement_factsheet のレスポンスには、独自の reviewed 日付が含まれます。
• 全件列挙： どちらのコンテンツコーパスも同梱されており、小規模です。supplement_factsheets() には約45のODSトピックがすべて掲載されています。約56種のNCCIHハーブは src/index.ts の NCCIH_HERBS に含まれており、どちらのリストにある名前も詳細を取得できます。DSLDの全コーパス（約21万5千件のラベル）は、同じソート済みページング（size／from）で列挙でき、一括利用向けにNIHがDSLDデータセット全体のダウンロードも https://dsld.od.nih.gov/ で公開しています。ファクトシートにはバージョン管理された一括ファイルがありません。これらについては、同梱された一覧を全件列挙する方法がスナップショットの取得手段です。

認証

キーは不要です。上流ソース3つ（ODSのファクトシート、DSLD、NCCIH）はすべて公開されているNIHサイトで、APIキーは必要ありません。

データソース

• https://ods.od.nih.gov/api/ — ODS ファクトシート XML API （?resourcename=<slug>&readinglevel=Consumer|HealthProfessional&outputformat=XML）。 注意点： ブラウザー風の User-Agent で初回に呼び出すと実際の XML が返りますが、 同じクライアントから短時間で 2 回目に呼び出すと、データではなくHTTP 200 と HTML のボットチェックページが返ってきます。同じステータスコードでエラーもなく、本文はまったく 異なります。このホストから返された HTML 形式の 200 を「見つからない」と判断しないでください。 「速度を落として再試行」という意味です。このパックでは、isolate ごとのキャッシュと 外部呼び出し間の最小間隔（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 にこのページを一度参照して手作業で同梱しています。 ほぼすべてのトピックでは、閲覧レベルが異なっても同じスラッグを使います。レベルは別の クエリパラメーターです。ただし、例外が 2 つあります。「Dietary Supplements in the Time of COVID-19」と Chromium は、レベルごとに異なるスラッグを使います。そのため一覧では、共通の スラッグ 1 つではなく、トピックごとに consumerSlug／professionalSlug を保存しています。
• 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 の「Herbs at a Glance」ページ。 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）も、2026-09-07 に nccih.nih.gov/health/herbsataglance を一度参照して手作業で同梱しています。こちらにもライブインデックスはありません。
• 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":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行してください。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの 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