Careflow Mcp

CareFlow MCP 🏥

n8n と Model Context Protocol を活用した、本番環境に対応する医療ワークフロー自動化です。Claude やその他の AI アシスタントが、自然言語を通じて HIPAA 準拠の患者タスク管理ワークフローを実行できます。

🏥 医療現場に対応：HIPAA 準拠に関する包括的なドキュメントと、患者タスク管理ワークフローが含まれています。

機能

• 🚀 ワークフローの実行 - カスタムペイロードを使用して、Webhook 経由で n8n ワークフローを実行します
• 📋 ワークフローの一覧表示 - n8n インスタンスからすべてのアクティブなワークフローを取得します
• 📊 ステータスの確認 - ワークフローの実行ステータスをリアルタイムで監視します
• 🏥 医療現場に対応 - 患者タスクのワークフローを標準でサポートします
• 🔒 型安全 - Zod による検証を備えた、完全な TypeScript サポート
• ⚡ 本番環境に対応 - 包括的なエラー処理とロギング
• 🛠️ MCP 標準 - Claude Desktop やその他の MCP クライアントと互換性があります

📚 ドキュメントとサンプル

• [ケーススタディ][(./case-studies/README.md)] - ROI 指標を含む、実際の導入例 5 件
• HEALTHCARE.md - HIPAA 準拠に関する包括的なガイド（本プロジェクトの差別化要因です！）
• ワークフローのサンプル - インポート可能な n8n ワークフローの JSON ファイル

サンプルを使ってすぐに開始

# 1. Import workflow to n8n
examples/healthcare-patient-task-workflow.json

# 2. Configure credentials in n8n

# 3. Ask Claude:
"Create a patient task for ID P12345 in the Patient Care workflow"

公開されるツール

ツール	説明	必須パラメーター
trigger_workflow	名前と JSON ペイロードを指定して n8n ワークフローを実行します	workflowName, payload
list_workflows	n8n のすべてのアクティブなワークフローを一覧表示します	なし
get_workflow_status	ID を指定して実行ステータスを確認します	executionId
create_patient_task	構造化された患者タスクをワークフローに送信します	workflowName, patientId, taskType

前提条件

• Node.js >= 18.0.0
• n8n インスタンス（クラウドまたはセルフホスト）と API アクセス
• n8n API キー（n8n の Settings > API で生成）

インストール

オプション 1：Smithery 経由（最も簡単）

Smithery を使って mcp.so から直接インストールします：

npx @smithery/cli install careflow-mcp

これにより、以下が自動的に行われます：

• パッケージをインストールします
• Claude Desktop の設定に追加します
• 必要な環境変数の入力を求めます

オプション 2：NPM インストール

npm install -g careflow-mcp

オプション 3：ソースからインストール

# Clone the repository
git clone https://github.com/pratapsfdc22-dev/careflow-mcp.git
cd careflow-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Link globally (optional)
npm link

設定

1. 環境ファイルを作成する

cp .env.example .env

2. 環境変数を設定する

n8n の認証情報を使って .env を編集します：

# Base URL of your n8n instance
N8N_BASE_URL=https://your-n8n-instance.com

# n8n API Key (Settings > API > Create API Key)
N8N_API_KEY=n8n_api_xxxxxxxxxxxxxxxxxxxxxxxx

# Optional: Webhook Secret
N8N_WEBHOOK_SECRET=your_webhook_secret

3. Claude Desktop を設定する

claude_desktop_config.json に追加します：

macOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "n8n-workflow": {
      "command": "node",
      "args": [
        "/path/to/careflow-mcp/dist/index.js"
      ],
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your_api_key_here",
        "N8N_WEBHOOK_SECRET": "your_webhook_secret"
      }
    }
  }
}

npm のグローバルインストールを使用する場合：

{
  "mcpServers": {
    "n8n-workflow": {
      "command": "careflow-mcp",
      "env": {
        "N8N_BASE_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your_api_key_here"
      }
    }
  }
}

使用例

1. ワークフローを実行する

// Ask Claude:
"Trigger the 'Customer Onboarding' workflow with this data:
{ email: '[email protected]', name: 'John Doe' }"

2. すべてのアクティブなワークフローを一覧表示する

// Ask Claude:
"Show me all active n8n workflows"

3. ワークフローの実行ステータスを確認する

// Ask Claude:
"Check the status of execution ID: abc123"

4. 患者タスクを作成する

// Ask Claude:
"Create a high-priority follow-up task for patient ID P12345
in the 'Patient Care' workflow, due tomorrow"

開発

ビルド

npm run build

ウォッチモード

npm run watch

ローカルで実行する

npm run dev

ビルド成果物をクリーンアップする

npm run clean

プロジェクト構成

careflow-mcp/
├── src/
│   ├── index.ts        # Main MCP server implementation
│   └── types.ts        # TypeScript types and Zod schemas
├── dist/               # Compiled JavaScript (generated)
├── .env.example        # Environment variable template
├── .gitignore          # Git ignore rules
├── package.json        # NPM package configuration
├── tsconfig.json       # TypeScript configuration
└── README.md           # This file

API リファレンス

trigger_workflow

名前と任意の JSON ペイロードを指定して n8n ワークフローを実行します。

入力：

{
  workflowName: string;    // Name of the workflow
  payload?: object;        // Optional JSON data
}

出力：

{
  "success": true,
  "workflowId": "abc123",
  "workflowName": "Customer Onboarding",
  "response": { ... }
}

list_workflows

n8n インスタンスからすべてのアクティブなワークフローを一覧表示します。

入力： なし

出力：

{
  "success": true,
  "count": 5,
  "workflows": [
    {
      "id": "abc123",
      "name": "Customer Onboarding",
      "active": true,
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-15T12:00:00.000Z"
    }
  ]
}

get_workflow_status

ワークフロー実行のステータスを確認します。

入力：

{
  executionId: string;    // Execution ID from trigger response
}

出力：

{
  "success": true,
  "execution": {
    "id": "exec123",
    "workflowId": "abc123",
    "finished": true,
    "status": "success",
    "startedAt": "2024-01-15T12:00:00.000Z",
    "stoppedAt": "2024-01-15T12:00:05.000Z"
  }
}

create_patient_task

構造化された患者タスクを n8n ワークフローに送信します。

入力：

{
  workflowName: string;          // Target workflow
  patientId: string;             // Patient identifier
  taskType: string;              // Task type
  priority?: "low" | "medium" | "high" | "urgent";
  description?: string;
  dueDate?: string;              // ISO 8601 format
  assignedTo?: string;
  metadata?: object;
}

出力：

{
  "success": true,
  "workflowId": "abc123",
  "workflowName": "Patient Care",
  "task": { ... },
  "response": { ... }
}

エラー処理

サーバーは、適切な MCP エラーコードを使用した包括的なエラー処理を実装しています。

• 無効なパラメーター - ErrorCode.InvalidParams
• メソッドが見つかりません - ErrorCode.MethodNotFound
• 内部エラー - ErrorCode.InternalError

すべてのエラーには、デバッグに役立つ説明的なメッセージが含まれます。

セキュリティのベストプラクティス

1. .env をコミットしないでください - テンプレートには必ず .env.example を使用してください
2. API キーをローテーションしてください - n8n の API キーを定期的に更新してください
3. Webhook シークレットを使用してください - Webhook トリガーに認証を追加してください
4. API アクセスを制限してください - n8n の API キーの権限を使用してください
5. ログを監視してください - 不審なアクティビティがないかサーバーログを確認してください

トラブルシューティング

サーバーが起動しない

# Check Node.js version
node --version  # Should be >= 18.0.0

# Verify environment variables
cat .env

# Check TypeScript compilation
npm run build

ワークフローが見つからない

• ワークフロー名が完全に一致していることを確認してください（大文字と小文字を区別します）
• n8n でワークフローが有効になっていることを確認してください
• API キーにワークフローへのアクセス権限があることを確認してください

認証に失敗する

• N8N_API_KEY が正しいことを確認してください
• N8N_BASE_URL にプロトコル（https://）が含まれていることを確認してください
• API キーの有効期限が切れていないことを確認してください

Webhook トリガーが失敗する

• ワークフローに Webhook ノードがあることを確認してください
• Webhook パスがワークフロー ID と一致していることを確認してください
• 必要に応じて N8N_WEBHOOK_SECRET を確認してください

コントリビューション

コントリビューションを歓迎します。以下の手順に従ってください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください。

謝辞

• Model Context Protocol SDK で構築
• n8n workflow automation を活用
• Zod による型検証

サポート

• 🐛 問題：GitHub Issues
• 💬 ディスカッション：GitHub Discussions
• 📖 ドキュメント：API リファレンス全文

---

Model Context Protocol で構築