🏥 MCP Server for AWS HealthLake (Mocked)

🏥 AWS HealthLake MCP 服务（模拟）

本项目是一个开源的模型上下文协议（MCP）服务，连接（模拟的）AWS HealthLake 数据源，并为临床模型提供结构化、标准化的上下文包。

✅ 功能

• 模拟 AWS HealthLake API（基于 FHIR）
• 按 MCP 规范打包上下文（FHIR + NLP）
• 模型注册和定制化上下文交付
• 模拟模型调用端点
• 审计日志
• 可选的 USE_AWS 标志，为未来集成 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 身份验证