MCP Ratchet Clinical Charting

🚀 mcp-ratchet-clinical-charting

Claudeを使用した臨床カルテ作成用のMCPサーバー（コードネーム: Ratchet） - 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 Desktopのテストに最適です。

利用可能なツール

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"]
    }
  }
}

本番モードで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サーバーを読み込むためにClaude Desktopを再起動します。

ステップ4: 検証

Claude Desktopで以下が表示されるはずです。

• 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 EMRに手動で入力する必要があります。

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 - テスト用のデモEMR Reactアプリ

📄 ライセンス

MIT

GRIMLOCK - 自律型MCPサーバーファクトリーを使用して構築されました