MCP Ratchet Clinical Charting

mcp-棘轮临床图

用于与Claude一起绘制临床图表的MCP服务器（代号：棘轮） -使Claude能够将患者就诊直接记录到电子病历中，从而减轻家庭健康护士的行政负担。

注： 目前以模拟模式运行以进行开发/测试。生产EMR集成即将推出。

状态

当前模式： 模拟模式-使用真实的测试数据进行开发和测试。

快速开始

来自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  # Development mode
npm test     # Run tests

模拟模式

棘轮跑了进来 模拟模式 默认情况下 POINTCARE_API_URL 未配置。模拟模式：

• 使用5个虚构的测试患者
• 将访问笔记存储在内存中
• 返回现实的响应
• 非常适合开发和Claude Desktop测试

可用工具

示例用法（克劳德语）

"Search for patient Eleanor Thompson"
→ Returns patient PT-10001 with demographics and status

"Create a visit note for PT-10001 with blood pressure 120/80"
→ Creates and stores visit note with vitals

"Get visit history for PT-10001"
→ Returns list of previous visits

Claude桌面集成

配置Claude桌面

添加到您的Claude Desktop配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json 窗户： %APPDATA%\Claude\claude_desktop_config.json

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

对于具有EMR集成的生产模式：

{
  "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 Desktop以加载新的MCP服务器。

步骤4：验证

在Claude Desktop中，您应该看到：

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

试试：“寻找病人埃莉诺”

测试患者（模拟模式）

起源故事

棘轮从 M2AI NurseCall n8n工作流程，旨在帮助家庭健康护士处理就诊文件：

Current Flow (M2AI NurseCall):
┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐
│ Twilio  │───>│  n8n    │───>│  VAPI   │───>│  Email  │
│  SMS    │    │ Workflow│    │  Call   │    │ Summary │
└─────────┘    └─────────┘    └─────────┘    └─────────┘

问题： 就诊记录会发送到电子邮件，但仍需要手动输入PointCare EMR。

棘轮解决方案：

Future Flow (with Ratchet):
┌─────────┐    ┌─────────┐    ┌──────────┐    ┌───────────┐
│ Twilio  │───>│  n8n    │───>│ Ratchet  │───>│ PointCare │
│  SMS    │    │ Workflow│    │   MCP    │    │    EMR    │
└─────────┘    └─────────┘    └──────────┘    └───────────┘

配置

\*生产使用所需。未设置时，模拟模式会激活。

项目结构

ratchet/
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── config.ts             # Configuration management
│   ├── tools/                # Tool implementations
│   │   ├── search-patient.ts
│   │   ├── create-visit-note.ts
│   │   └── get-patient-history.ts
│   ├── services/             # Business logic
│   │   ├── patient-service.ts
│   │   └── mock-data.ts
│   ├── types/                # TypeScript types
│   └── utils/                # Logger, errors
├── tests/
│   └── patient-service.test.ts
├── dist/                     # Compiled output
├── prds/
│   └── RATCHET-PRD.yaml
├── docs/
│   └── API_REQUIREMENTS.md
├── package.json
├── tsconfig.json
└── jest.config.js

发展

# Run in watch mode
npm run dev

# Run tests
npm test

# Run tests with coverage
npm test -- --coverage

# Lint
npm run lint

后续步骤

1. 获取PointCare API文档 -请参阅 docs/API_REQUIREMENTS.md
2. 完成PRD -使用真实的API详细信息填写工具规范
3. 实现真正的API调用 -替换模拟响应
4. 集成测试 -使用PointCare沙盒进行测试

相关项目

• 钢锁 -自主MCP服务器工厂
• 棘轮演示电动汽车 -演示EMR React应用程序进行测试

许可证

麻省理工学院

______________________________________________________________________

*内置于 钢锁 -自主MCP服务器工厂*