n8n-mcp

概述

n8n-mcp 是一個開源的 Model Context Protocol (MCP) 伺服器，在 AI 編碼助手與 n8n 工作流自動化平台之間搭建橋樑。它為 Claude Desktop、Claude Code、Cursor、Windsurf 和 VS Code 等工具提供 n8n 完整生態系統的結構化即時知識——包含 537 個核心節點 + 547 個社群節點（共 1,084 個）、2,709 個工作流模板，以及專為 AI 設計的驗證邏輯。

專案採用輕量級 Node.js 應用開發，內建 SQLite 資料庫，回應時間低於 12ms，支援 stdio 與 HTTP 兩種模式。只需連接一次，你的 AI 就能自主建構、驗證、測試並部署完整 n8n 工作流，無需複製貼上或手動設定。

託管版本（含開箱即用的 Chat Agent）可在 n8n-mcp.com 使用（提供免費額度與付費方案），GitHub 倉庫則完全支援 MIT 授權自託管。

核心功能

• 完整的節點知識庫 —— 完整支援 1,084 個 n8n 節點，屬性覆蓋率 99%，操作覆蓋率 63.6%，官方文件覆蓋率 87%（n8n 新版本發布後 48 小時內更新）。
• 智慧搜尋與探索 —— 提供 search_nodes、get_node（多種詳細模式）以及依來源（verified/community）篩選社群節點的功能。
• 真實世界範例 —— 從熱門模板中預先擷取 2,646 個設定。
• 進階驗證功能 —— validate_node 與 validate_workflow，支援 AI Agent 設定檔、執行階段檢查與相依性分析。相容 n8n v2.17+ 的 AI Agent 工作流。
• 模板引擎 —— 可搜尋並取得 2,709+ 個立即可用的工作流 JSON，並提供智慧篩選。
• n8n 管理工具（選用 API 連線）—— 可直接在你的 n8n 實例中建立、更新、測試、執行與自動修復工作流。
• 效能與相容性 —— 平均回應約 12ms，記憶體占用 70–120 MB，支援任何 Node.js 版本。相容 stdio（Claude Desktop）與 HTTP/SSE 模式。
• 隱私與安全 —— 可選匿名遙測（可輕鬆停用），無硬編碼憑證，支援 webhook 安全模式。

安裝與設定

快速開始（npx，無需安裝）

npx n8n-mcp

然後在 Claude Desktop 的 claude_desktop_config.json 中加入設定，並設定 MCP_MODE=stdio。

Docker（推薦用於正式環境）

docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest

雲端部署（一鍵部署）

透過倉庫模板免費部署至 Railway。

本地完整建置

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start

選用環境變數：N8N_API_URL、N8N_API_KEY（用於直接管理工作流）、LOG_LEVEL=error、MCP_MODE=stdio。

支援的 AI 助手

• Claude Desktop / Claude Code
• Cursor
• Windsurf
• VS Code + Codex
• Antigravity
• 任何相容 MCP 的客戶端（託管服務支援 20+ 工具）

使用情境

• AI 驅動的工作流建立 —— 描述「監控 Twitter 提及並將帶情緒分析的摘要發送到 Slack」→ AI 自動產生、驗證並部署完整 JSON。
• 現有工作流維護 —— AI 讀取線上工作流，提出最佳化建議並套用針對性更新。
• 模板探索 —— 詢問「使用社群節點的最佳 CRM 同步模板」，即可取得可直接匯入的 JSON。
• 企業級自動化 —— 連接自託管 n8n 實例，實現大規模、安全、可稽核的工作流生成。
• 學習與原型開發 —— 使用驗證工具在正式部署前教會 AI 最佳實務。

n8n 內建 MCP 與 n8n-mcp 的差異

n8n 原生 MCP 伺服器（近期版本已提供）會將你自己的工作流暴露為工具。而 n8n-mcp 是一個互補的外部 MCP 伺服器，專注於 n8n 節點知識 與 AI 輔助創作。兩者搭配使用可發揮最大威力：原生伺服器用於觸發工作流，n8n-mcp 用於智慧工作流建構。

連結與資源

• GitHub: czlonkowski/n8n-mcp
• 託管 Chat Agent 與儀表板: n8n-mcp.com
• 免費額度：託管版每日 100 次工具呼叫，或自託管無限使用
• 文件與範例皆在倉庫中

n8n-mcp 能瞬間將任何 AI 編碼助手轉變為全栈 n8n 工作流專家。