MedAdapt コンテンツサーバー

PubMed、NCBI Bookshelf、およびユーザー提供のドキュメントから教育リソースを取得して処理することで、AI 支援による医療学習を強化する、Claude Desktop 専用の Model Context Protocol (MCP) サーバーです。

概要

MedAdaptコンテンツサーバーはClaude Desktopと統合され、医学教育コンテンツの検索、取得、分析のためのツールを提供します。Claudeと医学知識ソースをつなぐ橋渡しとして機能し、AIを活用した学習体験の向上を実現します。

Related MCP server: Mutation Clinical Trial Matching MCP

クイックスタート

# Clone the repository
git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

# Install dependencies
pip install -r requirements.txt

# Run the server
python content_server.py

特徴

• コンテンツ検索: 複数のソースから医学教育コンテンツを検索

• リソース検索: 完全な記事、本の章、ユーザードキュメントを取得します

• トピックの概要: 医療トピックの包括的な概要を生成します

• 学習リソース: トピックと生徒のレベルに基づいて適切な学習リソースを提案します

• 学習計画: 目標とリソースを備えた構造化された学習計画を作成します

• コンテンツ分析：医療リソースから重要なポイント、方法論、および調査結果を抽出する

• ユーザーコンテンツ: ユーザー提供のドキュメントをインポートして分析する

インストール

標準インストール

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

git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

2. 仮想環境を作成します (オプションですが推奨されます)。

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

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

pip install -r requirements.txt

4. 設定（オプション）:

   • レート制限の改善のために NCBI API キーを取得してください: https://ncbiinsights.ncbi.nlm.nih.gov/2017/11/02/new-api-keys-for-the-e-utilities/

   • .env.exampleに基づいて.envファイルを作成する

使用法

サーバーの実行

python content_server.py

Claude Desktopとの統合

1. クロードデスクトップを開く

2. 設定→モデルコンテキストプロトコル→サーバーの追加に移動します

3. 次の場所にあるclaude_desktop_config.jsonファイルで次の JSON を使用して構成します。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "medadapt": {
      "command": "/path/to/python",
      "args": [
        "/path/to/medadapt-content-server/content_server.py"
      ],
      "env": {
        "DB_PATH": "/path/to/medadapt-content-server/medadapt_content.db"
      }
    }
  }
}

/path/to/pythonを実際のPythonパス（例： /opt/anaconda3/bin/pythonまたはC:\Python311\python.exe ）に置き換えます。/path/to/medadapt-content-server/ /path/to/medadapt-content-server/クローンしたリポジトリへの絶対パスに置き換えます。

重要: DB_PATH環境変数により、データベース ファイルが絶対パスで作成され、アクセスされるようになり、一般的なファイル アクセス エラーが防止されます。

初期トピックマッピングの設定

python populate_topics.py

テスト

すべてが機能していることを確認するためにテストを実行します。

python test_server.py

クロードとの使用例

シナリオ1：医学的トピックについて学ぶ

クロードへのユーザープロンプト:

I'd like to learn about the cardiac cycle. Can you provide a big picture overview and help me understand the key concepts?

シナリオ2: 特定のリソースを見つける

クロードへのユーザープロンプト:

I need to find recent research articles about COVID-19 treatment options. Can you help me find relevant resources?

シナリオ3：学習計画の作成

クロードへのユーザープロンプト:

I'm a second-year medical student studying neurology. Can you create a learning plan for understanding stroke pathophysiology?

利用可能なツール

サーバーは、Claude に次のツールを提供します。

• search_medical_content : フィルターを使用して医療コンテンツを検索

• get_resource_content : 特定のリソースの完全なコンテンツを取得する

• get_topic_overview : 医療トピックの包括的な概要を生成する

• suggest_learning_resources : パーソナライズされたリソースの推奨事項を取得する

• import_user_document : ユーザー提供の学習教材をアップロードする

• generate_learning_plan : 目標に基づいた構造化された学習計画を作成する

• extract_article_key_points : 医学論文から重要な知見を抽出する

トラブルシューティング

よくある問題と解決策

1. データベース接続エラー

   • 症状: sqlite3.OperationalError: unable to open database file

   • 解決策: Claude Desktop 構成でDB_PATH環境変数が正しく設定され、アプリケーションが書き込み権限を持つ絶対パスを指していることを確認します。

2. ファイルパスエラー

   • 症状: No such file or directoryというエラー

   • 解決策: Claude Desktop 構成内のすべてのパスが、余分な引用符やエスケープ文字のない絶対パスであることを確認します。

3. APIレート制限

   • 症状: PubMed または NCBI Bookshelf からの応答が遅い、または応答がない

   • 解決策: NCBI APIキーを取得し、 .envファイルに追加します

4. クロード・デスクトップ接続

   • 症状: クロードがMCPサーバーに接続できない

   • 解決策: ターミナルウィンドウでサーバーが実行されており、Claude Desktopで適切に構成されていることを確認します。

プロジェクト構造

medadapt-content-server/
│
├── content_server.py     # Main MCP server implementation
├── database.py          # SQLite database interface
├── pubmed_utils.py      # PubMed API utilities
├── bookshelf_utils.py   # NCBI Bookshelf utilities
├── populate_topics.py   # Script to populate initial topic data
├── test_server.py       # Test script
├── requirements.txt     # Python dependencies
├── .env.example         # Example environment variables
└── README.md            # Documentation

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

謝辞

• PubMedおよびBookshelf APIへのアクセスを提供するNCBI

• クロードとMCP統合機能のためのAnthropic