MCP Ratchet Clinical Charting

🚀 臨床病歷記錄MCP服務器（代號：Ratchet）

此項目為使用Claude進行臨床病歷記錄的MCP服務器，可讓Claude直接將患者就診信息記錄到電子病歷中，減輕居家護理護士的行政負擔。

🚀 快速開始

從npm安裝（推薦）

npx mcp-ratchet-clinical-charting

從源代碼安裝

git clone https://github.com/m2ai-mcp-servers/mcp-ratchet-clinical-charting.git
cd mcp-ratchet-clinical-charting
npm install
npm run build
npm run dev  # 開發模式
npm test     # 運行測試

✨ 主要特性

• 支持Claude直接將患者就診信息記錄到電子病歷中，減輕居家護理護士的行政負擔。
• 目前支持模擬模式，可用於開發和測試，未來將集成生產環境的電子病歷系統。
• 提供了多個工具，如搜索患者、創建就診記錄、獲取患者就診歷史等。

📦 安裝指南

從npm安裝（推薦）

npx mcp-ratchet-clinical-charting

從源代碼安裝

git clone https://github.com/m2ai-mcp-servers/mcp-ratchet-clinical-charting.git
cd mcp-ratchet-clinical-charting
npm install
npm run build
npm run dev  # 開發模式
npm test     # 運行測試

💻 使用示例

基礎用法

在Claude中使用示例：

"Search for patient Eleanor Thompson"
→ 返回患者PT - 10001的人口統計信息和狀態

"Create a visit note for PT-10001 with blood pressure 120/80"
→ 創建並存儲包含生命體徵的就診記錄

"Get visit history for PT-10001"
→ 返回之前的就診記錄列表

📚 詳細文檔

狀態信息

當前模式：模擬模式 - 使用逼真的測試數據進行開發和測試。

模擬模式

當未配置POINTCARE_API_URL時，Ratchet默認以模擬模式運行。模擬模式具有以下特點：

• 使用5個虛構的測試患者。
• 將就診記錄存儲在內存中。
• 返回逼真的響應。
• 非常適合開發和Claude桌面版測試。

可用工具

Claude桌面版集成

配置Claude桌面版

將以下內容添加到Claude桌面版配置文件中： macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ratchet": {
      "command": "npx",
      "args": ["-y", "mcp-ratchet-clinical-charting"]
    }
  }
}

生產模式下與電子病歷系統集成的配置：

{
  "mcpServers": {
    "ratchet": {
      "command": "npx",
      "args": ["-y", "mcp-ratchet-clinical-charting"],
      "env": {
        "POINTCARE_API_URL": "https://api.pointcare.com",
        "POINTCARE_API_KEY": "your-api-key"
      }
    }
  }
}

步驟3：重啟Claude桌面版

重啟Claude桌面版以加載新的MCP服務器。

步驟4：驗證

在Claude桌面版中，你應該能看到：

• search_patient工具可用
• create_visit_note工具可用
• get_patient_history工具可用

可以嘗試輸入："Search for patient Eleanor"

測試患者（模擬模式）

起源故事

Ratchet源於M2AI NurseCall的n8n工作流，該工作流旨在幫助居家護理護士進行就診記錄：

當前流程（M2AI NurseCall）:
┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│ Twilio  │───>│  n8n    │───>│  VAPI   │───>│  Email  │
│  SMS    │    │ Workflow│    │  Call   │    │ Summary │
└─────────┘    └─────────┘    └─────────┘    └─────────┘

問題：就診記錄通過電子郵件發送，但仍需手動輸入到PointCare電子病歷系統中。

Ratchet的解決方案：

未來流程（使用Ratchet）:
┌─────────┐    ┌─────────┐    ┌──────────┐    ┌───────────┐
│ Twilio  │───>│  n8n    │───>│ Ratchet  │───>│ PointCare │
│  SMS    │    │ Workflow│    │   MCP    │    │    EMR    │
└─────────┘    └─────────┘    └──────────┘    └───────────┘

配置信息

*生產環境使用時必需。未設置時激活模擬模式。

項目結構

ratchet/
├── src/
│   ├── index.ts              # MCP服務器入口點
│   ├── config.ts             # 配置管理
│   ├── tools/                # 工具實現
│   │   ├── search-patient.ts
│   │   ├── create-visit-note.ts
│   │   └── get-patient-history.ts
│   ├── services/             # 業務邏輯
│   │   ├── patient-service.ts
│   │   └── mock-data.ts
│   ├── types/                # TypeScript類型
│   └── utils/                # 日誌記錄器、錯誤處理
├── tests/
│   └── patient-service.test.ts
├── dist/                     # 編譯輸出
├── prds/
│   └── RATCHET-PRD.yaml
├── docs/
│   └── API_REQUIREMENTS.md
├── package.json
├── tsconfig.json
└── jest.config.js

開發

# 以監聽模式運行
npm run dev

# 運行測試
npm test

# 運行測試並生成覆蓋率報告
npm test -- --coverage

# 代碼檢查
npm run lint

下一步計劃

1. 獲取PointCare API文檔 - 查看docs/API_REQUIREMENTS.md
2. 完成產品需求文檔（PRD） - 使用真實的API細節填充工具規範
3. 實現真實的API調用 - 替換模擬響應
4. 集成測試 - 使用PointCare沙箱進行測試

相關項目

• GRIMLOCK - 自主MCP服務器工廠
• ratchet-demo-emr - 用於測試的演示電子病歷React應用

📄 許可證

本項目採用MIT許可證。

使用GRIMLOCK - 自主MCP服務器工廠構建