Medadapt Content Server

🚀 医療用アダプティブコンテンツサーバー

Claude Desktop向けに設計された専用のモデルコンテキストプロトコル（MCP）サーバーです。PubMed、NCBI Bookshelf、およびユーザーが提供する教育リソースから情報を取得・処理することで、AIによる医学学習体験を強化します。

🚀 クイックスタート

医療用アダプティブコンテンツサーバーを起動するには、以下の手順を実行します。

# リポジトリをクローンする
git clone https://github.com/ryoureddy/medadapt-content-server.git
cd medadapt-content-server

# 依存関係をインストールする
pip install -r requirements.txt

# サーバーを起動する
python content_server.py

✨ 主な機能

• コンテンツ検索：複数のソースから医学教育コンテンツを検索します。
• リソース取得：完全な記事、書籍の章、およびユーザーが提供するドキュメントを取得します。
• テーマ概要：医学テーマの包括的な概要を生成します。
• 学習リソース推薦：テーマと学生のレベルに基づいて、適切な教育リソースを提案します。
• 学習計画作成：目標とリソースを含む構造化された学習計画を作成します。
• コンテンツ分析：教育コンテンツから重要なポイント、方法、および発見を抽出します。
• ユーザーコンテンツインポート：ユーザーが提供するドキュメントをインポートして分析します。

📦 インストール

標準インストール

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

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

2. プロジェクトディレクトリに移動します。

cd medadapt-content-server

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

pip install -r requirements.txt

💻 使用例

基本的な使用法

Claude Desktopの設定

1. Claude Desktopを開きます。
2. 設定にアクセスし、MCPサーバーの設定を見つけます。
3. 以下の情報を入力します。
   • 名前：医療用アダプティブコンテンツサーバー
   • アドレス：localhost:5000
   • 認証情報（オプション）：認証が必要な場合は、適切な認証情報を入力します。
4. 設定を保存し、MCPサーバーを有効にします。

接続の検証

1. 医療用アダプティブコンテンツサーバーを起動します。

python content_server.py

2. 別のターミナルウィンドウで、以下のコマンドを実行してClaudeとの接続をテストします。

curl -X POST http://localhost:5000/api/test

高度な使用法

利用可能なユーティリティを使用して、特定のタスクを実行できます。

• PubMed APIユーティリティ：pubmed_utils.py
• NCBI Bookshelfユーティリティ：bookshelf_utils.py
• 初期テーマデータ充填スクリプト：populate_topics.py

📚 ドキュメント

トラブルシューティング

一般的な問題と解決策

1. データベースパスエラー
   • 症状：ファイルまたはディレクトリが見つからない。
   • 解決策：Claude Desktopの設定でDB_PATH環境変数が絶対パスに設定されており、アプリケーションに書き込み権限があることを確認してください。
2. APIレート制限
   • 症状：PubMedまたはNCBI Bookshelfからの応答が遅い、または失敗する。
   • 解決策：NCBI APIキーを取得し、.envファイルに追加してください。
3. Claude Desktop接続問題
   • 症状：ClaudeがMCPサーバーに接続できない。
   • 解決策：サーバーが実行中であり、Claude Desktopで正しく設定されていることを確認してください。

プロジェクト構造

医療用アダプティブコンテンツサーバー/
│
├── content_server.py     # 主なMCPサーバーの実装
├── database.py          # SQLiteデータベースインターフェース
├── pubmed_utils.py      # PubMed APIユーティリティ
├── bookshelf_utils.py   # NCBI Bookshelfユーティリティ
├── populate_topics.py   # 初期テーマデータを充填するスクリプト
├── test_server.py       # テストスクリプト
├── requirements.txt     # Pythonの依存関係
├── .env.example         # 環境変数のサンプルファイル
└── README.md            # ドキュメント

📄 ライセンス

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

謝辞

• NCBIは、PubMedおよびBookshelf APIへのアクセスを提供しています。
• Anthropicは、ClaudeとそのMCP統合機能を提供しています。