🏥 MCP Server for AWS HealthLake (Mocked)

🏥 AWS HealthLake 用 MCP サーバー（モック）

このプロジェクトは、（モックの）AWS HealthLake データソースに接続し、臨床モデル向けに構造化・標準化されたコンテキストバンドルを提供するオープンソースの Model Context Protocol（MCP）サーバーです。

✅ 機能

• AWS HealthLake API のモック（FHIR ベース）
• MCP 仕様に準拠したコンテキストバンドル（FHIR + NLP）
• モデルの登録と、モデルに合わせたコンテキストの提供
• モデル呼び出しエンドポイントのモック
• 監査ログ
• 将来の AWS 連携に備えたオプションの USE_AWS フラグ

---

🚀 クイックスタート

1. クローンまたはダウンロード

unzip mcp-server.zip
cd ahl-mcp-server

2. Python の依存関係をインストール

python3 -m venv venv
source venv/bin/activate        # On Windows: venv\Scripts\activate
pip install -r requirements.txt

3. ローカルで実行（モックモード）

uvicorn app.main:app --reload

アクセス先：http://localhost:8000/docs

---

🔁 エンドポイント

📦 MCP エンドポイント

エンドポイント	メソッド	説明
/context/{patient_id}	GET	コンテキストバンドルを取得
/models/register	POST	モデル情報を登録
/models/{model_id}/context/{patient_id}	GET	モデルに合わせたコンテキスト
/model/invoke/{model_id}?patient_id=...	POST	モデル予測のモック

🧪 HealthLake モックエンドポイント

エンドポイント	メソッド	説明
/ahl/Patient	POST	患者を作成
/ahl/Patient/{id}	GET	患者を取得
/ahl/Condition?patient=...	GET	病状を取得
/ahl/MedicationRequest?patient=...	GET	薬剤を取得
/ahl/Observation?patient=...	GET	検査結果を取得
/ahl/mock/add_*	POST	モックデータを追加（病状／薬剤／観察結果）

---

⚙️ モックモードと AWS モードの切り替え

デフォルトでは、アプリはモックモードで実行されます。

将来の AWS 連携に備えるには、次のようにします。

export USE_AWS=true

注：AWS モードはまだ実装されていませんが、連携できる状態です。

---

🧪 テストの実行

pytest tests/

---

📂 フォルダー構成

app/
├── api/                # API endpoints
├── core/               # Config and logging
├── fhir/               # Placeholder for FHIR connector
├── models/             # Pydantic models
├── nlp/                # NLP mock enhancer
├── services/           # Context resolver, policy logic
├── main.py             # FastAPI entry
infra/
tests/                  # Test cases
schemas/                # MCP JSON schema
.env
requirements.txt

---

📜 ライセンス

MIT ライセンス

---

🧠 今後の予定

• AWS HealthLake との連携（boto3）
• Amazon Comprehend Medical／Bedrock モデル
• Dockerfile + ECS デプロイ
• リアルタイムのコホート検索
• SMART-on-FHIR 認証