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服务器工厂构建