# n8n-mcp

n8n-mcp 是一個 Model Context Protocol (MCP) 伺服器，可讓 Claude Desktop、Cursor、Windsurf 等 AI 助手完整存取 n8n 的 1,084+ 個節點、文件、模板與管理工具，讓它們能夠自主建構、驗證並部署生產等級的工作流。

Canonical URL: https://a2a-mcp.org/entry/n8n-mcp-zh-tw

Language: zh-TW

Category: MCP Servers

Updated: 2026-03-26

## 概述

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](https://www.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，無需安裝）
```bash
npx n8n-mcp
```
然後在 Claude Desktop 的 `claude_desktop_config.json` 中加入設定，並設定 `MCP_MODE=stdio`。

### Docker（推薦用於正式環境）
```bash
docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest
```

### 雲端部署（一鍵部署）
透過倉庫模板免費部署至 Railway。

### 本地完整建置
```bash
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](https://github.com/czlonkowski/n8n-mcp)
- 託管 Chat Agent 與儀表板: [n8n-mcp.com](https://www.n8n-mcp.com)
- 免費額度：託管版每日 100 次工具呼叫，或自託管無限使用
- 文件與範例皆在倉庫中

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

## Tags

- mcp-server
- n8n
- ai-assistant
- workflow-automation
- claude-desktop
- cursor
- typescript
- node-js
- mcp
- automation

## Sources

- [Project website](https://github.com/czlonkowski/n8n-mcp)