czlonkowski/n8n-mcp

n8n‑MCP – 為 n8n 所設計的「模型上下文協定」伺服器

它是什麼

• 一個輕量級 HTTP 服務，將 n8n 工作流自動化節點（約 2,400 個節點）的完整目錄以 AI 模型（Claude、ChatGPT 等）可查詢的結構化資料形式公開。
• 可以將其視為 n8n 的可搜尋知識庫：節點名稱、屬性、操作、範例設定與文件均可透過一組明確定義的 API 呼叫取得。

為何重要

• 大型語言模型可產生或編輯 n8n 工作流，但需要可靠且即時的節點資訊。n8n‑MCP 提供此等上下文，減少幻覺與損壞的工作流。
• 透過在 n8n 實例中整合 MCP 客戶端節點，您可讓 AI 助手 發現模板、取得節點規格、驗證設定，甚至自動部署工作流。

核心功能（如 README 所述）

功能	你能獲得什麼
節點目錄	2,412 個節點（829 個核心，1,583 個社群）涵蓋 99% 屬性與 66% 操作。
文件	86% 的官方 n8n 文件，以及 AI 專用節點文件。
AI 就緒工具	267 個標記為「AI 能力」的節點變體。
真實世界範例	從熱門社群模板中提取的 156 個排名配置。
範本圖書館	2,352 個即用型工作流範本，每個均附帶 AI 元資料註解。
搜尋與檢索	支援搜尋節點、屬性、範本與社群整合的工具，可依複雜度、受眾、所需服務等進行過濾。
驗證流程	多階段驗證（minimal → full → 工作流級）於部署前捕捉遺漏參數。
管理 API	一旦透過 N8N_API_URL/N8N_API_KEY 指向您自己的 n8n 實例，即可透過程式化方式建立、更新、測試與刪除工作流。
安全警告	強烈建議勿直接以 AI 編輯生產環境工作流；始終複製、測試並備份。

如何使用

1. 立即試用 – 主機化儀表板（dashboard.n8n-mcp.com）提供每日 100 次免費工具呼叫；只需註冊並取得 API 金鑰。
2. 自架設 – 專案提供 Docker 影像、npx 啟動器與 Railway 部署指令碼，適合需要控制權或更高限制的使用者。
3. 連接至 n8n – 在任意 n8n 工作流中加入 MCP Client Tool 節點，設定 API 金鑰，即可呼叫 MCP 工具（如 search_nodes、get_node、validate_workflow）。
4. 與 AI IDE 整合 – 專案提供 Claude Code、VS Code（Copilot）、Cursor、Windsurf、Codex 與 Antigravity 的現成設定指南，讓這些助手在背景中呼叫 MCP 工具。
5. 部署工作流 – 透過 MCP 工具建構工作流後，可使用 n8n_create_workflow 推送至您的 n8n 實例，以 n8n_test_workflow 執行測試，並讓伺服器自動修復常見錯誤（n8n_autofix_workflow）。

典型的 AI 助手工作流程

1. tools_documentation()          # 取得 MCP 背景資訊
2. search_templates({task:'slack notification'})
3. get_template(id, {mode:'full'})
4. validate_workflow(workflow)
5. n8n_create_workflow(workflow)   # 部署至您的 n8n 實例

README 還詳細列出「Claude 專案設定」，包含強制靜默並行執行與強制範本引用的系統指令。

安全與治理

• 透過停用破壞性工具並使用唯讀 n8n API 金鑰，可將伺服器運行於 唯讀 模式，適用於受監管環境。
• 支援 Cloudflare Access，可將 n8n API 保護於零信任架構下。
• 提供完整的加固、隱私與遙測文件。

誰會受益

• 開發者：希望在無需手動查找節點規格的情況下，藉由 AI 協助建構複雜自動化的人。
• 團隊：希望向內部 LLM 助手提供經篩選、可搜尋的 n8n 知識庫的人。
• AI 工具廠商：正在尋找可直接整合 n8n 功能的即用型協定的廠商。

---

總結：n8n‑MCP 是一個真正的、生產級的橋樑，將 n8n 節點生態系統轉化為 AI 模型可用的機器可讀知識來源，具備搜尋、驗證與部署能力。