mcp-ratchet-clinical-charting

mcp-ratchet-clinical-charting

Claude を使用した臨床カルテ記録用 MCP サーバー（コードネーム：Ratchet） - Claude が電子カルテに患者の診察内容を直接記録できるようにし、訪問看護師の事務作業の負担を軽減します。

注記： 現在は開発・テスト用のモックモードで動作します。本番環境の電子カルテ連携は近日対応予定です。

ステータス

コンポーネント	ステータス
MCP サーバー	✅ 動作中（モックモード）
単体テスト	✅ 20/20 件合格
Claude Desktop	✅ テスト準備完了
PointCare API	⏳ API ドキュメント待ち

現在のモード： モックモード — 開発とテスト用に現実的なテストデータを使用します。

クイックスタート

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 が設定されていない場合、Ratchet はデフォルトでモックモードで動作します。モックモードでは、次のようになります。

• 架空のテスト患者 5 名を使用します
• 診察記録をメモリー上に保存します
• 現実的な応答を返します
• 開発や Claude Desktop のテストに最適です

利用可能なツール

ツール	説明	モックモード
search_patient	名前、ID、または電話番号で患者を検索します	✅ 動作中
create_visit_note	バイタル情報を含む患者の診察記録を作成します	✅ 動作中
get_patient_history	患者の診察履歴を取得します	✅ 動作中

使用例（Claude 内）

"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 Desktop との連携

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します。

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 Desktop を再起動する

新しい MCP サーバーを読み込むため、Claude Desktop を再起動します。

ステップ 4：確認する

Claude Desktop に次のツールが表示されます。

• search_patient ツールが利用可能
• create_visit_note ツールが利用可能
• get_patient_history ツールが利用可能

「患者の Eleanor を検索して」と試してみてください。

テスト患者（モックモード）

ID	名前	ステータス	主な診断
PT-10001	Eleanor Thompson	アクティブ	2 型糖尿病、うっ血性心不全
PT-10002	Robert Martinez	アクティブ	COPD、術後
PT-10003	Margaret Wilson	アクティブ	パーキンソン病
PT-10004	James Thompson	アクティブ	脳卒中後のリハビリ
PT-10005	Dorothy Anderson	退院済み	股関節置換術

開発の経緯

Ratchet は、訪問看護師の診察記録作成を支援するために構築された M2AI NurseCall の n8n ワークフローから発展しました。

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

課題： 診察記録はメールで届きますが、PointCare の電子カルテには手動で入力する必要があります。

Ratchet の解決策：

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

設定

変数	必須	説明
POINTCARE_API_URL	いいえ*	PointCare API のベース URL
POINTCARE_API_KEY	いいえ*	API キーまたはトークン
RATCHET_MOCK_MODE	いいえ	モックモードを強制します（true/false）
LOG_LEVEL	いいえ	ログレベル（debug/info/warn/error）

*本番環境での使用には必須です。未設定の場合はモックモードが有効になります。

プロジェクト構成

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 のサンドボックスでテストします

関連プロジェクト

• GRIMLOCK - 自律型 MCP サーバーファクトリー
• ratchet-demo-emr - テスト用デモ電子カルテ React アプリ

ライセンス

MIT

---

GRIMLOCK で構築 - 自律型 MCP サーバーファクトリー