Nci Evs

@pipeworx/nci-evs

NCI Thesaurus（NCIt）の概念と、NCI Enterprise Vocabulary Services REST API が提供するその他の管理用語集です。CDISC、GDC、CTRP、SEER、NCI の治験システムがキーとして使用する C コードを扱います。

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

ツール

• evs_search_concepts(term, terminology?, type?, include?, page_size?, from_record?) — 名前 → コード。デフォルトでは NCIt を検索します。同じ API が提供する ICD-10、MedDRA、SNOMED CT、 HGNC、GO なども検索できます。
• evs_concept(code, terminology?, include?) — コード → 完全なレコード：優先名、出典付きの定義、 用語タイプと出典を含むすべての同義語、意味タイプ、ICD-O-3 / ICD-10 / MedDRA への用語集間マッピング。
• evs_terminologies(latest_only?) — クエリ可能な用語集と、それぞれの読み込み済みバージョンを確認します。概念レコードは バージョンに照らして初めて解釈できるため、回答のバージョンを固定するのに使います。
• evs_concept_relations(code, terminology?, kinds?) — 親、子、役割、関連、逆関連、子孫を取得します。治験データやゲノムデータを 検索する前に、疾患をそのサブタイプに展開するために使います。

認証

キーは不要です。

データソース

• https://api-evsrest.nci.nih.gov/api/v1/concept/{terminology}/search — 用語検索。
• https://api-evsrest.nci.nih.gov/api/v1/concept/{terminology}/{code} — 1 つの概念。
• https://api-evsrest.nci.nih.gov/api/v1/concept/{terminology}/{code}/{parents|children|roles|associations|inverseAssociations|inverseRoles|descendants} — 関連。
• https://api-evsrest.nci.nih.gov/api/v1/metadata/terminologies — 読み込み済みの用語集。

注意点

API のバージョンプレフィックスは /api/v1 であり、/ のみではありません。 NCI の説明文ではパスから省略されています。これがないと、すべての呼び出しが、エンドポイントが廃止されたように見える Spring の「No static resource」本文とともに 404 になります。

関連は別々のエンドポイントであり、include ではありません。 /relationships パスは存在せず、404 になります。親、子、役割、関連はそれぞれ独自のサブパスです。例外は maps です。これは概念エンドポイントの include 値であり、サブパスではありません。evs_concept_relations はサブパスを並列で取得し、種類ごとの件数を報告するため、実際に行がない種類と取得に失敗した種類を区別できます。

include=minimal は検索時のデフォルトで、定義が省略されます。 検索結果に含まれるのはコード／名前／ステータスのみです。summary または full を指定するまでは定義が含まれないため、「API に定義がない」という結論は、通常、include の指定に関する問題です。

バージョン文字列は変わります。 概念の version（例：NCIt の 26.08e）は月次リリースを表します。数週間離れた時点で取得した 2 つの回答が異なるのは正常です。コードの意味が重要な場合は、バージョンを明記してください。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/nci-evs/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/evs_search_concepts \
  -H 'Content-Type: application/json' \
  -d '{"term":"melanoma","page_size":5}'

最初の呼び出しにはアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/evs_search_concepts を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

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

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

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

または、起動を確認するには、直接実行します。

npx -y @pipeworx/mcp-nci-evs

stdin／stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールはありません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Nci Evs data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT