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%（新版本发布后 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 工作流专家。