N8n Monitoring MCP

🚀 n8n監控MCP服務器

專門用於n8n工作流監控並進行KPI分析的MCP服務器。為Claude AI助手提供3種專注於n8n工作流執行分析的監控工具。部署在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等）
  • 每個工作流的指標和失敗率
  • 時序分析（平均/最大/最小執行時間）
  • 近期失敗分析
  • 高失敗率自動警報
• 速率限制：每個租戶每分鐘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桌面集成

將以下內容添加到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桌面並嘗試以下提示：

• "列出所有活動的n8n工作流"
• "顯示最近50次執行的工作流執行KPI"
• "獲取最近失敗的工作流執行的詳細信息"

🔧 技術細節

速率限制

• 默認值：每個租戶每分鐘100個請求
• 租戶ID：基於X-N8N-URL和X-N8N-API-KEY的組合
• 響應頭：
  • X-RateLimit-Remaining：當前窗口中剩餘的請求數
  • X-RateLimit-Reset：速率限制重置前的秒數
• 速率限制超出：返回HTTP 429響應

架構

┌─────────────────────────┐
│  客戶端 (Claude桌面)    │
│  + 請求頭:              │
│    X-N8N-URL           │
│    X-N8N-API-KEY       │
└───────────┬─────────────┘
            │
            ▼
┌─────────────────────────┐
│  Cloudflare Worker      │
│  - 速率限制             │
│  - 多租戶路由           │
│  - KPI處理              │
└───────────┬─────────────┘
            │
    ┌───────┴───────┐
    ▼               ▼
┌─────────┐   ┌─────────┐
│ 租戶1   │   │ 租戶2   │
│ n8n-no1 │   │ n8n-no2 │
└─────────┘   └─────────┘

開發

# 運行類型檢查
npm run typecheck

# 查看即時日誌
npm run tail

# 本地測試
npm run dev

與n8n-mcp-workers的主要區別

📄 許可證

本項目採用MIT許可證，請參閱LICENSE文件。

致謝

• 基於 n8n-mcp-workers
• 從n8n工作流（ID: f8exh14YagxEj1To）移植
• 使用 Model Context Protocol 構建

支持

• 問題反饋：GitHub Issues
• n8n文檔：docs.n8n.io
• MCP文檔：modelcontextprotocol.io

貢獻

歡迎貢獻代碼！請提交問題或拉取請求。