n8n-MCP 是一个轻量但强大的 Model Context Protocol（MCP）服务，它像一位精通 n8n 的“AI翻译官”，把 n8n 平台中全部 1650 个自动化节点（含 820 个官方核心节点 + 830 个优质社区节点）的文档、参数、输入输出结构、使用示例等，以 AI 友好的结构化方式实时提供给 Claude Desktop、Claude Code、Windsurf、Cursor 等支持 MCP 协议的智能编程助手。它解决了 AI 在写 n8n 工作流时“知其然不知其所以然”的痛点——不再靠猜测或过时教程，而是直接调用权威、最新、可执行的节点知识。
核心功能
- 全量节点语义理解：自动解析并暴露 n8n 官方与社区全部 1650+ 节点的完整元数据，包括字段类型、必填项、默认值、描述文案及典型用法
- MCP 标准协议支持：严格遵循 Model Context Protocol 规范，开箱即用对接 Claude、Cursor、Windsurf 等新一代 AI 编程环境，无需定制适配
- 零代码工作流生成辅助：AI 助手可基于真实节点能力，精准生成可运行的 n8n JSON 工作流，大幅减少调试和试错成本
- 动态文档同步：随 n8n 版本升级自动更新节点信息（当前已适配 n8n v2.18.4），确保 AI 获取的知识始终与生产环境一致
- 多部署形态支持：提供 npm 包、Docker 镜像（ghcr.io/czlonkowski/n8n-mcp）、Railway 一键部署按钮，3 分钟即可在本地或云端启动服务
- 轻量安全设计：纯 TypeScript 实现，无外部依赖风险；默认仅提供只读上下文信息，不开放执行权限，保障自动化环境安全
适合哪些人用
如果你是以下角色之一，n8n-MCP 将显著提升你的自动化开发效率：
✅ n8n 中级/高级用户：常需快速组合复杂节点，但苦于查阅文档耗时、参数易出错；
✅ 低代码/自动化工程师：负责为团队搭建标准化工作流模板，希望借助 AI 加速方案设计与交付；
✅ AI 编程实践者：已在使用 Cursor 或 Claude Code 进行开发，渴望让 AI 深度理解你所依赖的自动化平台；
✅ 技术布道师与培训讲师：需要向学员直观演示“AI 如何协同构建真实工作流”，而非抽象概念。
快速上手
最简方式：点击 Railway 一键部署按钮，登录后选择区域，30 秒获得公网可访问的 MCP 服务地址。
本地运行：执行 npm install -g n8n-mcp && n8n-mcp，服务默认启动在 http://localhost:3000；
Docker 启动：运行 docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp；
启动后，在 Cursor 或 Claude Code 的设置中将 MCP Server URL 填为你的服务地址（如 http://localhost:3000），即可立即启用智能节点补全与工作流生成。
项目信息
A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
19.4k
今日 +264 stars today
Stars
3.2k
Forks
TypeScript
MIT
编程语言：TypeScript｜GitHub Star 数：19391｜开源协议：MIT｜GitHub 项目地址
这不仅是 GitHub 上备受关注的自动化领域明星项目，更是中文开发者构建 AI 增强型低代码工作流时，不可绕过的「智能知识中枢」——让 AI 不再瞎猜，而是真正读懂你的自动化引擎。
