Epic Ehr MCP Server Db

🏥 EPIC EHR MCP服务器

用于具有OAuth 2.0身份验证的电子健康记录的生产就绪模型上下文协议（MCP）服务器。

🚀 快速开始

1.安装依赖项

pip install -r requirements.txt

2.设置数据库（仅限第一次）

如果您有现有数据：

• 数据库文件 ehr_database.db 已包含
• 跑 python seed_database.py 添加OAuth客户端

如果重新开始：

python seed_database.py

这将创建数据库模式和OAuth客户端。

3.启动服务器

python server.py --websocket

服务器运行于： ws://0.0.0.0:7777

⚠️ 重要： 这 oauth_clients_credentials.json 该文件包含您的OAuth凭据，请确保其安全！

🔐 认证

用途 OAuth 2.0客户端凭据 流量：

# Authenticate
{
  "client_id": "client_abc123...",
  "client_secret": "secret_xyz789...",
  "app_id": "copilot-studio"
}

# Returns access_token for API calls

📋 可用工具

• 验证 -OAuth 2.0身份验证
• 注册表_客户端 -注册新的OAuth客户端
• validate_token -验证访问令牌
• get_patient -通过MRN获取患者
• 搜索_患者 -按姓名搜索患者
• 创建_患者 -创建新患者
• get_appoints -预约患者
• 时间表_预约 -安排新的预约
• get_指示 -获取患者药物
• 处方用药 -开新药
• get_lab_results -获取实验室结果
• get_vital_signs -获取生命体征
• record_vital_signs -记录新的生命体征
• 获取_过敏反应 -引起患者过敏

🌐 部署

DigitalOcean水滴

1. 创建快捷批处理程序 （Ubuntu 22.04 LTS）

1. 克隆存储库

   git clone 
   cd epic-ehr-mcp-server-db

1. 安装Python及其依赖项

   sudo apt update
   sudo apt install python3 python3-pip python3-venv -y
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt

1. 配置环境

   cp .env.example .env
   nano .env  # Edit with production values

1. 上载数据库

   # Upload ehr_database.db and oauth_clients_credentials.json to server
   scp ehr_database.db root@your-droplet:/home/ehrserver/epic-ehr-mcp-server-db/
   scp oauth_clients_credentials.json root@your-droplet:/home/ehrserver/

1. 使用systemd运行 （参见DEPLOYMENT.md）

环境变量

DATABASE_URL=sqlite:///ehr_database.db
JWT_SECRET_KEY=your-production-secret-key
SERVER_HOST=0.0.0.0
SERVER_PORT=7777

🔒 安全

• OAuth 2.0客户端凭据
• JWT代币（60分钟到期）
• 使用SHA-256散列的客户端机密
• 基于角色的访问控制
• 基于范围的权限

📊 数据库模式

• oauth_客户端 -OAuth客户端凭据
• 患者 -患者人口统计
• 提供商 -医疗保健提供者
• 预约 -患者预约
• 药物 -处方
• 过敏 -患者过敏
• 生命体征 -生命测量
• 实验室结果 -实验室结果

🧪 测试

# Test authentication
python -c "from auth import authenticate_client; print(authenticate_client('client_id', 'secret', 'app_id'))"

📚 文档

• 建筑.md -系统架构
• DATABASE_SCHEMA.md -数据库架构详细信息
• 部署.md -部署指南
• oauth_clients_credentials.json -OAuth凭据（gitignored）

🎯 Microsoft Copilot Studio集成

此服务器专为Microsoft Copilot Studio MCP集成而设计：

1. 在Copilot Studio中配置MCP连接
2. 使用WebSocket URL: ws://your-server:7777
3. 从提供OAuth凭据 oauth_clients_credentials.json
4. Copilot Studio自动发现所有工具

📞 支持

• 端口：7777（WebSocket）
• 协议：MCP（模型上下文协议）
• 身份验证：OAuth 2.0客户端凭据

📝 许可证

MIT许可证-请参阅许可证文件

______________________________________________________________________

版本： 1.0.0\ 最后更新时间： 2025年11月28日