MedAdapt Content Server

MedAdapt コンテンツサーバー

PubMed、NCBI Bookshelf、およびユーザー提供のドキュメントから学習用リソースを取得して処理することで、AI を活用した医学学習を強化する、Claude Desktop 向けの専門的な Model Context Protocol（MCP）サーバーです。

概要

MedAdapt Content Server は Claude Desktop と連携し、医学教育コンテンツを検索、取得、分析するためのツールを提供します。Claude と医学知識の情報源をつなぐ橋渡しとして機能し、AI を活用した学習体験を向上させます。

クイックスタート

# 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. Claude Desktop を開きます
2. Settings → Model Context Protocol → Add Server に移動します
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/ をクローンしたリポジトリの絶対パスに置き換えます。

重要：DB_PATH 環境変数を設定すると、データベースファイルが絶対パスで作成およびアクセスされるため、よくあるファイルアクセスエラーを防げます。

初期トピックマッピングの登録

python populate_topics.py

テスト

すべてが正常に動作していることを確認するため、テストを実行します：

python test_server.py

Claude での使用例

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

Claude へのユーザープロンプト：

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

シナリオ 2：特定のリソースを探す

Claude へのユーザープロンプト：

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

シナリオ 3：学習計画を作成する

Claude へのユーザープロンプト：

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. Claude Desktop への接続

   • 症状：Claude が 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 の下でライセンスされています。詳細については LICENSE ファイルを参照してください。

謝辞

• PubMed と Bookshelf の API へのアクセスを提供している NCBI
• Claude と MCP 統合機能を提供している Anthropic