N8n Monitoring MCP

🚀 n8nモニタリングMCPサーバー

KPI分析を備えたn8nワークフローモニタリング用の専用MCPサーバーです。Claude AIアシスタントに、n8nワークフローの実行分析に特化した3つのモニタリングツールを提供します。Cloudflare Workers上にデプロイされ、グローバルなエッジパフォーマンスを実現します。

🚀 クイックスタート

前提条件

• Node.js 18以上とnpm
• Cloudflareアカウント（無料プランでも可）
• APIアクセスが可能なn8nインスタンス
• n8n APIキー（こちらで作成）

インストール

# リポジトリをクローン
git clone https://github.com/YOUR_USERNAME/n8n-monitoring-mcp.git
cd n8n-monitoring-mcp

# 依存関係をインストール
npm install

# Cloudflareにログイン
npx wrangler login

ローカル開発

# ローカル開発サーバーを起動
npm run dev

# curlでテスト
curl -X POST http://localhost:8787 \
  -H "Content-Type: application/json" \
  -H "X-N8N-URL: https://your-n8n-instance.com" \
  -H "X-N8N-API-KEY: your_api_key" \
  -d '{"method":"tools/list"}'

Cloudflare Workersへのデプロイ

# 本番環境にデプロイ
npm run deploy

# WorkerのURLを取得
# https://n8n-monitoring-mcp.YOUR_SUBDOMAIN.workers.dev

✨ 主な機能

• 3つのモニタリングツール：

  • n8n_get_active_workflows - すべてのアクティブなワークフローをリスト表示
  • n8n_get_workflow_executions - 包括的なKPI分析を含む実行履歴を取得
  • n8n_get_execution_details - エラーメッセージを含む詳細な失敗情報を取得

• マルチテナント対応：リクエストヘッダー（X-N8N-URL、X-N8N-API-KEY）を使用して、異なるn8nインスタンスを利用できます。

• 包括的なKPI分析：

  • 実行の概要（合計、成功、失敗、失敗率）
  • 実行モードの分布（手動、トリガー、Webhookなど）
  • ワークフローごとのメトリクスと失敗率
  • タイミング分析（平均/最大/最小実行時間）
  • 最近の失敗分析
  • 高い失敗率に対する自動アラート

• レート制限：テナントごとに1分間に100リクエスト

• サーバーレス&グローバル：Cloudflare Workers上にデプロイされ、世界中で低遅延を実現します。

💻 使用例

基本的な使用法

1. n8n_get_active_workflows

n8nインスタンス内のすべてのアクティブなワークフローをリスト表示します。

パラメーター：なし

リクエスト例：

{
  "method": "tools/call",
  "params": {
    "name": "n8n_get_active_workflows",
    "arguments": {}
  }
}

レスポンス例：

[
  {
    "id": "f8exh14YagxEj1To",
    "name": "Workflow Execution Audit",
    "active": true,
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-20T14:22:00.000Z"
  }
]

2. n8n_get_workflow_executions

包括的なKPI分析を含むワークフローの実行履歴を取得します。

パラメーター：

• limit（数値、オプション）：取得する最大実行数（デフォルト: 100）
• workflowId（文字列、オプション）：特定のワークフローIDでフィルタリング

リクエスト例：

{
  "method": "tools/call",
  "params": {
    "name": "n8n_get_workflow_executions",
    "arguments": {
      "limit": 50
    }
  }
}

レスポンス例：

{
  "executionCount": 50,
  "kpis": {
    "summary": {
      "total": 50,
      "success": 42,
      "failed": 8,
      "waiting": 0,
      "running": 0,
      "failureRate": 16.0
    },
    "modes": {
      "trigger": 35,
      "webhook": 10,
      "manual": 5
    },
    "workflowMetrics": [
      {
        "workflowId": "abc123",
        "workflowName": "Data Sync Workflow",
        "total": 25,
        "success": 20,
        "failed": 5,
        "failureRate": 20.0
      }
    ],
    "timeMetrics": {
      "avgExecutionTime": 3500,
      "maxExecutionTime": 12000,
      "minExecutionTime": 500
    },
    "failureAnalysis": {
      "recentFailures": [...],
      "workflowsWithFailures": ["abc123", "def456"],
      "totalFailedWorkflows": 2
    },
    "alerts": [
      "⚡ 中程度の失敗率: 16%の実行が失敗しました"
    ]
  }
}

3. n8n_get_execution_details

失敗した実行の詳細情報を取得します。エラーメッセージを含みます。

パラメーター：

• limit（数値、オプション）：取得する最大失敗実行数（デフォルト: 20）
• workflowId（文字列、オプション）：特定のワークフローIDでフィルタリング

リクエスト例：

{
  "method": "tools/call",
  "params": {
    "name": "n8n_get_execution_details",
    "arguments": {
      "limit": 10,
      "workflowId": "abc123"
    }
  }
}

レスポンス例：

{
  "failedExecutionCount": 5,
  "failures": [
    {
      "executionId": "exec123",
      "workflowId": "abc123",
      "workflowName": "Data Sync Workflow",
      "mode": "trigger",
      "startedAt": "2025-01-26T10:30:00.000Z",
      "errorMessage": "Connection timeout",
      "errorDescription": "Failed to connect to external API after 30 seconds",
      "lastNodeExecuted": "HTTP Request"
    }
  ]
}

高度な使用法

Claude Desktopとの統合

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "n8n-monitoring": {
      "url": "https://n8n-monitoring-mcp.YOUR_SUBDOMAIN.workers.dev",
      "transport": {
        "type": "http"
      },
      "headers": {
        "X-N8N-URL": "https://your-n8n-instance.com",
        "X-N8N-API-KEY": "your_n8n_api_key"
      }
    }
  }
}

Claude Desktopを再起動し、以下のプロンプトを試してみてください。

• "List all active n8n workflows"
• "Show me workflow execution KPIs for the last 50 executions"
• "Get details of recent failed workflow executions"

📚 ドキュメント

レート制限

• デフォルト：テナントごとに1分間に100リクエスト
• テナントID：X-N8N-URLとX-N8N-API-KEYの組み合わせに基づく
• レスポンスヘッダー：
  • X-RateLimit-Remaining：現在のウィンドウ内で残りのリクエスト数
  • X-RateLimit-Reset：レート制限がリセットされるまでの秒数
• レート制限超過：HTTP 429レスポンス

アーキテクチャ

┌─────────────────────────┐
│  Client (Claude Desktop)│
│  + Request Headers:     │
│    X-N8N-URL           │
│    X-N8N-API-KEY       │
└───────────┬─────────────┘
            │
            ▼
┌─────────────────────────┐
│  Cloudflare Worker      │
│  - Rate limiting        │
│  - Multi-tenant routing │
│  - KPI processing       │
└───────────┬─────────────┘
            │
    ┌───────┴───────┐
    ▼               ▼
┌─────────┐   ┌─────────┐
│ Tenant 1│   │ Tenant 2│
│ n8n-no1 │   │ n8n-no2 │
└─────────┘   └─────────┘

開発

# 型チェックを実行
npm run typecheck

# ライブログを表示
npm run tail

# ローカルでテスト
npm run dev

n8n-mcp-workersとの主な違い

コントリビューション

コントリビューションを歓迎します！IssueまたはPRを開いてください。

クレジット

• n8n-mcp-workersをベースにしています。
• n8nワークフロー（ID: f8exh14YagxEj1To）から移植されています。
• Model Context Protocolを使用して構築されています。

サポート

• 問題報告: GitHub Issues
• n8nドキュメント: docs.n8n.io
• MCPドキュメント: modelcontextprotocol.io

📄 ライセンス

MITライセンス - LICENSEファイルを参照してください。