Health Record MCP

🚀 EHR 工具項目文檔

本項目聚焦於醫療健康領域，藉助 SMART on FHIR 標準和 Model Context Protocol (MCP) 構建工具集，助力用戶以多樣化方式訪問和處理電子健康記錄（EHR）數據。

✨ 主要特性

• SMART on FHIR 集成：可與符合 SMART on FHIR 標準的 ehr - sim 平臺開展交互。
• Model Context Protocol (MCP)：藉助 MCP 協議實現對 ehr - sim 模擬器的訪問與控制。

🚀 快速開始

本項目提供兩種操作模式，以下為您詳細介紹。

📦 安裝指南

1. 本地運行模式（通過標準輸入輸出）

此模式適用於開發環境，支持藉助命令行工具啟動服務，並與 ehr - sim 模擬器進行交互。

使用步驟

1. 創建數據庫：

   # 示例：將數據保存到 data/my_record.sqlite 文件中
   bun run src/cli.ts --create-db --db ./data/my_record.sqlite
   

   打開瀏覽器，依照提示連接到 ehr - sim 模擬器。

2. 啟動 MCP 服務：

   # 示例：使用已創建的數據庫文件啟動服務
   bun run src/cli.ts --db ./data/my_record.sqlite
   

配置要求

• 配置文件：需提供一個品牌配置文件（例如 config.epicsandbox.json），其中包含以下信息：

  • url：指定品牌的定義文件路徑（如 static/brands/epic - sandbox.json）。
  • tags：用於分類和過濾的品牌標籤數組（例如 [ "epic", "sandbox" ]）。
  • vendorConfig：包含 SMART on FHIR 客戶端詳細信息（如 clientId, scopes）。

• 客戶端配置：

  {
    "mcpServers": {
      "local - ehr": {
        "name": "本地 EHR 搜索",
        "command": "bun", // 或 bun 的絕對路徑
        "args": [
          "/home/user/projects/smart - mcp/src/cli.ts", // cli.ts 的絕對路徑
          "--db",
          "/home/user/projects/smart - mcp/data/my_record.sqlite" // 數據庫文件的絕對路徑
        ]
      }
    }
  }
  

2. 全局運行模式（通過服務器發送事件）

該模式提供持久化的網絡服務，支持多個客戶端連接，使用服務器發送事件（SSE）進行通信。

特性

• 身份驗證：採用 OAuth 2.1 協議實現客戶端認證。
• 數據獲取：在授權過程中自動完成 SMART on FHIR 流程，並將 ClientFullEHR 數據存儲於內存或持久化會話中。

注意事項

⚠️ 重要提示

• 目前 OAuth 2.1 客戶端支持有限，僅適用於專門的開發或調試工具。
• 此模式仍處於實驗階段。