Clinicaltrialsgov MCP Server

🚀 ClinicalTrials.gov MCP Server

AIエージェントに、公式ClinicalTrials.govデータベースへの直接アクセス機能を付与しましょう！

このMCP（Model Context Protocol）サーバーは、公式のClinicalTrials.gov v2 APIに対して、堅牢で開発者にやさしいインターフェースを提供します。LLMやAIエージェントが、臨床研究データをプログラムで検索、取得、分析できるようになります。

cyanheads/mcp-ts-templateをベースに構築されており、このサーバーはモジュール型アーキテクチャを採用し、堅牢なエラーハンドリング、ロギング、セキュリティ機能を備えています。

🚀 クイックスタート

このサーバーは、AIに専用ツールを提供して、ClinicalTrials.govデータベースとやり取りできるようにします。

目次

概要

ClinicalTrials.gov MCPサーバーは、橋渡しの役割を果たし、Model Context Protocol（MCP）を理解するアプリケーション（MCPクライアント）、例えば高度なAIアシスタント（LLM）、IDE拡張機能、またはカスタム研究ツールが、公式のClinicalTrials.govデータベースと直接かつ効率的にやり取りできるようにします。

複雑なAPI統合や手動検索の代わりに、このサーバーを活用することで、ツールは以下のことができます。

• 臨床研究ワークフローを自動化する：臨床試験を検索し、詳細な研究メタデータを取得し、試験特性をプログラムで分析します。
• 研究洞察を得る：ホストアプリケーションから離れることなく、研究プロトコル、適格基準、アウトカム、スポンサー、および場所を含む包括的な試験データにアクセスします。
• AI駆動の研究に臨床試験データを統合する：LLMが臨床試験レビューを行い、研究トレンドを分析し、エビデンスベースの意思決定をサポートできるようにします。
• 規制およびコンプライアンスワークフローをサポートする：規制提出、競合情報、および市場調査のための構造化データを取得します。

堅牢なmcp-ts-templateをベースに構築されており、このサーバーは、MCP標準を介してClinicalTrials.govの機能を公開する標準化された、安全で効率的な方法を提供します。公式のClinicalTrials.gov v2 APIと統合することで、レート制限に準拠し、包括的なエラーハンドリングを提供します。

開発者へのメモ：このリポジトリには.clinerulesファイルが含まれており、コードベースのパターン、ファイルの場所、およびコードスニペットのクイックリファレンスとして、LLMコーディングエージェントの開発者チートシートとして機能します。

✨ 主な機能

コアユーティリティ

mcp-ts-templateが提供する堅牢なユーティリティを活用しています。

• ロギング：構造化された、設定可能なロギング（ファイルローテーション、stdout JSON、MCP通知）で、機密データを非表示にします。
• エラーハンドリング：集中的なエラー処理、標準化されたエラータイプ（McpError）、および自動ロギング。
• 設定：Zodを使用した包括的な検証で、環境変数を読み込みます（dotenv）。
• 入力検証/サニタイズ：zodを使用したスキーマ検証とカスタムサニタイズロジック。
• リクエストコンテキスト：AsyncLocalStorageを使用した一意のリクエストIDによる操作の追跡と関連付け。
• 型安全：TypeScriptとZodスキーマによって強制される強い型付け。
• HTTPトランスポート：セッション管理と認証サポートを備えた、高性能なHTTPサーバー（Honoを使用）。
• 認証：JWTとOAuth 2.1をサポートする堅牢な認証レイヤーで、細かいスコープ制御が可能。
• デプロイメント：ネイティブ依存関係をサポートする小さく安全な本番用イメージを作成するためのマルチステージDockerfile。

ClinicalTrials.gov統合

• 公式API統合：自動JSON解析を備えた、ClinicalTrials.gov v2 APIエンドポイントへの包括的なアクセス。
• 高度な検索機能：研究ステータス、地理的場所、条件、介入、およびスポンサーに対するフィルターを持つ複雑なクエリ構築。
• 完全な研究メタデータ：プロトコル、適格基準、研究デザイン、アウトカム、スポンサー、および連絡先情報を含む完全な試験データを取得します。
• 柔軟なフィールド選択：効率的なAPI使用とレスポンスサイズの削減のために、取得する特定のデータフィールドを選択します。
• ページネーションサポート：pageSizeとpageTokenパラメータを使用した組み込みのページネーションで、大きな結果セットを処理します。
• データクリーニング：APIレスポンスから冗長な情報を自動的にクリーニングし、簡素化して、消費しやすくします。
• レート制限遵守：ClinicalTrials.gov APIガイドラインに準拠するための組み込みのリクエスト制限。

📦 インストール

前提条件

• Node.js (>=18.0.0)
• npm （Node.jsに付属）

MCPクライアント設定

MCPクライアントの設定ファイル（例：cline_mcp_settings.json）に以下を追加します。この設定では、npxを使用してサーバーを実行し、パッケージがまだインストールされていない場合は自動的にインストールされます。

{
  "mcpServers": {
    "clinicaltrialsgov-mcp-server": {
      "command": "npx",
      "args": ["clinicaltrialsgov-mcp-server"],
      "env": {
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

手動で実行する場合（開発またはテスト用にMCPクライアントを介さない場合）

npmを使用してインストール

npm install clinicaltrialsgov-mcp-server

ソースからインストール

1. リポジトリをクローンします。

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

2. 依存関係をインストールします。

   npm install
   

3. プロジェクトをビルドします。

   npm run build
   

設定

環境変数

環境変数を使用してサーバーを設定します。ローカル開発の場合は、これらをプロジェクトルートの.envファイルに設定するか、直接環境に設定できます。それ以外の場合は、上記のようにMCPクライアント設定に設定することもできます。

プロジェクト構造

コードベースは、src/ディレクトリ内でモジュール型構造に従っています。

src/
├── index.ts              # エントリポイント：サーバーを初期化して起動します
├── config/               # 設定の読み込み（環境変数、パッケージ情報）
│   └── index.ts
├── mcp-server/           # コアMCPサーバーロジックと機能登録
│   ├── server.ts         # サーバーのセットアップ、機能登録
│   ├── transports/       # トランスポートの処理（stdio、http）
│   └── tools/            # MCPツールの実装（ツールごとのサブディレクトリ）
├── services/             # 外部サービスの統合
│   └── clinical-trials-gov/ # ClinicalTrials.gov APIクライアントと型
├── types-global/         # 共有のTypeScript型定義
└── utils/                # 共通のユーティリティ関数（ロガー、エラーハンドラーなど）

詳細なファイルツリーを表示するには、npm run treeを実行するか、docs/tree.mdを参照してください。

💻 ツール

ClinicalTrials.gov MCPサーバーは、臨床試験研究のための包括的なツールセットを提供し、Model Context Protocolを介して呼び出すことができます。

注：すべてのツールは包括的なエラーハンドリングをサポートし、構造化されたJSONレスポンスを返します。

💻 使用例

包括的な使用例は、examples/ディレクトリにあります。

• 研究の一覧
• 研究の詳細を取得

開発

ビルドとテスト

# プロジェクトをビルドする（TSをJSにコンパイルしてdist/に出力し、実行可能にする）
npm run build

# MCPインスペクターツールを使用してサーバーをローカルでテストする（stdioトランスポート）
npm run inspector

# MCPインスペクターツールを使用してサーバーをローカルでテストする（httpトランスポート）
npm run inspector:http

# ビルドアーティファクトをクリーンアップする
npm run clean

# ドキュメント用のファイルツリー表現を生成する
npm run tree

# ビルドアーティファクトをクリーンアップしてからプロジェクトを再構築する
npm run rebuild

# Prettierでコードをフォーマットする
npm run format

# stdioを使用してサーバーを起動する（デフォルト）
npm start
# または明示的に指定する場合：
npm run start:stdio

# HTTPトランスポートを使用してサーバーを起動する
npm run start:http

📄 ライセンス

このプロジェクトは、Apache License 2.0の下でライセンスされています。詳細については、LICENSEファイルを参照してください。