clinicaltrialsgov-mcp-server

公開ホストサーバー: https://clinicaltrials.caseyjhand.com/mcp

概要

治験の検索、発見、分析、マッチングを行うための7つのツール：

Related MCP server: ClinicalTrials.gov MCP Server

ツール

clinicaltrials_search_studies

ClinicalTrials.govのクエリ機能を備えた主要な検索ツール。

• 全文検索およびフィールド指定クエリ（疾患、介入、スポンサー、場所、タイトル、結果）

• 型指定された列挙値によるステータスおよびフェーズフィルター

• 座標と距離による地理的近接フィルタリング

• 複雑なクエリのための高度なAREA[] Essie式サポート

• ペイロードサイズを削減するためのフィールド選択（完全なレコードは各約70KB）

• カーソルトークンによるページネーション、任意のフィールドによるソート

clinicaltrials_get_study_results

完了した研究の公開結果データを取得します。

• 統計、有害事象、参加者の流れ、ベースライン特性を含む結果指標

• セクションレベルのフィルタリング（必要なデータのみをリクエスト）

• オプションのサマリーモードにより、完全な結果（約200KB）を重要なメタデータ（研究あたり約5KB）に圧縮

• 呼び出しごとに複数のNCT IDをバッチ処理し、部分的な成功を報告

• 結果のない研究と取得エラーの個別追跡

clinicaltrials_find_eligible

患者のプロフィールを適格な募集中の治験とマッチングします。

• 患者の人口統計として年齢、性別、疾患、場所を取得

• 人口統計フィルター（年齢範囲、性別、健康なボランティア）を備えた最適化されたAPIクエリを構築

• 呼び出し元が評価できるように、適格性と場所のフィールドを含む研究を返します

• 一致する研究がない場合に実行可能なヒント（疾患の拡大、フィルターの調整など）を提供

特徴

@cyanheads/mcp-ts-core 上に構築：

• Zodスキーマとフォーマット関数を使用した宣言的なツール/リソース/プロンプト定義

• 統一されたエラーハンドリング — ハンドラーが例外をスローし、フレームワークがキャッチして分類

• デュアルトランスポート：同一コードベースからstdioとStreamable HTTPの両方に対応

• HTTPトランスポート用のプラグイン可能な認証（none, jwt, oauth）

• オプションのOpenTelemetryトレースを備えた構造化ログ

ClinicalTrials.gov固有：

• ClinicalTrials.gov REST API v2 用の型安全なクライアント

• 公開API — 認証やAPIキーは不要

• 指数バックオフ（3回試行）によるリトライとレート制限（約1リクエスト/秒）

• HTMLエラー検出と構造化エラーファクトリー

はじめに

公開ホストインスタンス

公開インスタンスが https://clinicaltrials.caseyjhand.com/mcp で利用可能です。インストールは不要です。Streamable HTTP経由で任意のMCPクライアントから接続してください。

{
  "mcpServers": {
    "clinicaltrialsgov-mcp-server": {
      "type": "streamable-http",
      "url": "https://clinicaltrials.caseyjhand.com/mcp"
    }
  }
}

セルフホスト / ローカル

MCPクライアントの設定（例：claude_desktop_config.json）に追加してください：

{
  "mcpServers": {
    "clinicaltrialsgov-mcp-server": {
      "type": "stdio",
      "command": "bunx",
      "args": ["clinicaltrialsgov-mcp-server@latest"],
      "env": {
        "MCP_TRANSPORT_TYPE": "stdio"
      }
    }
  }
}

またはStreamable HTTPの場合：

MCP_TRANSPORT_TYPE=http
MCP_HTTP_PORT=3010

前提条件

• Bun v1.2.0 以上（またはNode.js >= 22.0.0）

インストール

1. リポジトリをクローン:

   git clone https://github.com/cyanheads/clinicaltrialsgov-mcp-server.git

2. ディレクトリに移動:

   cd clinicaltrialsgov-mcp-server

3. 依存関係をインストール:

   bun install

設定

すべての設定はオプションです。サーバーはデフォルト設定で動作し、APIキーは不要です。

サーバーの実行

ローカル開発

• 本番バージョンのビルドと実行:

  bun run build
  bun run start:http   # or start:stdio

• 開発モードで実行（ウォッチ機能付き）:

  bun run dev:http     # or dev:stdio

• チェックとテストの実行:

  bun run devcheck     # Lints, formats, type-checks
  bun run test         # Runs test suite

Docker

docker build -t clinicaltrialsgov-mcp-server .
docker run -p 3010:3010 clinicaltrialsgov-mcp-server

プロジェクト構造

開発ガイド

開発ガイドラインとアーキテクチャルールについては CLAUDE.md を参照してください。要約：

• ハンドラーが例外をスローし、フレームワークがキャッチする — ツールロジック内に try/catch を書かない

• リクエストスコープのログには ctx.log を使用し、console 呼び出しは行わない

• 新しいツールやリソースは index.ts バレルファイルに登録する

貢献

Issueやプルリクエストを歓迎します。提出前にチェックを実行してください：

bun run devcheck
bun run test

ライセンス

Apache-2.0 — 詳細は LICENSE を参照してください。