
n8n-mcp 是一个 Model Context Protocol 服务器,作者 czlonkowski,用 TypeScript 写的,GitHub 上 2.3 万星、MIT 协议,免费。它把 n8n 的 3,143 个节点(841 个官方核心节点 + 2,302 个社区节点)的文档、参数结构、可用操作整理成 AI 助手能直接查的资料,让 Claude、Cursor 这类工具在搭流程时不再靠猜字段名。
核心功能
- 节点库覆盖广:3,143 个节点(841 核心 + 2,302 社区,其中 1,879 个已验证),属性覆盖 99%,操作覆盖 66.5%,文档覆盖 86%,AI 相关节点一并收录
- 参数按需返回:同一个节点能选三种详略:minimal 约 200 token 只看基本信息,standard 带必填项和示例,full 给全量参数(3,000–8,000 token),避免一次塞爆上下文
- 模板先于自建:内置 2,352 条官方工作流模板,可按任务类型、复杂度、预计搭建分钟数、所需服务筛选,先找现成的再改,比从零拼节点稳
- 会校验再交付:提供节点校验和整套工作流校验,能指出缺哪个必填字段、连线结构哪里不对,让 AI 改完自己验一遍再交给你
项目信息
| 项目 | czlonkowski/n8n-mcp |
| 开源协议 | MIT |
| 技术栈 | TypeScript / Node.js,发布到 npm 与 ghcr.io 镜像 |
| 节点数据 | 3,143 节点 / 2,352 模板 / 267 个 AI 工具变体 |
| 兼容客户端 | Claude Code、Cursor、VS Code(Copilot)、Windsurf、Codex 等 MCP 客户端 |
| 部署方式 | npx 一行、Docker、Railway 模板,或官方托管面板(免费档每天 100 次调用) |
| 对接 n8n | 填 N8N_API_URL + N8N_API_KEY 即可读写自己的实例;走 Cloudflare Access 的站另有服务令牌字段 |
什么场景下有用
- 已经在用 Claude Code 或 Cursor,想让它直接产出能导入 n8n 的流程 JSON 的人
- 被节点参数反复折腾、希望 AI 先查文档再动手的自动化从业者
- 团队里做 n8n 二次开发,需要一套稳定的节点元数据来源的工程师
- 不打算自己维护服务、只想试效果的轻度用户(用官方托管免费档)
它解决什么问题
让 AI 帮忙搭 n8n 流程,最常见的失败不是它不会写逻辑,而是它不知道节点长什么样。凭记忆编出来的字段名多半对不上,参数默认值也常被它顺手当成正确值,结果 JSON 导进去一片红叹号,你还得逐个节点对照文档改名。节点总数已经三千多个,官方文档翻起来也不轻。这类工具做的事很朴素:把「这个节点有哪些字段、哪些必填、能不能接下一个」变成结构化数据喂给模型,让它少猜。
怎么开始用
- 先定接入方式:图省事用官方托管面板注册拿 API Key,接进客户端即可,免费档每天 100 次工具调用;要完全自控就用 npx 本地跑
- 本地跑的命令很直白,设好 N8N_API_URL 和 N8N_API_KEY 两个环境变量,再按官方给的一段 MCP 配置写进客户端(Claude Code、Cursor 各有一份现成示例)
- 接上后先让它搜模板而不是搜节点:一句「找简单的 webhook 处理模板」,比让它从头拼五个节点快得多,也更少出错
- 拿到流程后务必在测试实例里跑一遍,先建副本再改。作者在 README 里用大字提醒:不要直接拿 AI 改生产环境的工作流
你可能想问
问:这东西跟直接用 ChatGPT 问 n8n 有啥区别?
答:区别在数据来源。它是把 n8n 节点的真实参数结构查出来给模型,而不是让模型凭训练记忆编字段名,所以生成的 JSON 更容易一次导入成功。
问:必须自己有 n8n 实例吗?
答:查文档、搜模板、校验配置这些不需要实例;但要让 AI 直接在你的实例上建流程、跑 webhook,就得填实例地址和 API Key,这一步是可选的。
问:会不会写着写着把线上流程改坏?
答:会,作者自己也在文档里警告过。规避办法很简单:给 AI 的实例权限单独开一个测试环境,动生产前先导出一份 JSON 备份。
问:每天 100 次调用够用吗?
答:搭一条中等复杂度的流程通常十几二十次调用,一天三五条没问题。要高频用就本地 npx 部署,那样没有次数限制。
问:换客户端要重配吗?
答:配置内容一样,只是各客户端的 MCP 配置文件位置不同。作者为 Claude Code、Cursor、VS Code、Windsurf、Codex 各准备了一份设置文档,照着写就行。
以上信息据 GitHub 项目页与官方文档整理,代码与用法以仓库当前版本为准。
最后更新:2026-10-27
