n8n-mcp:让 Claude 查准 3143 个节点,再把流程连出来

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 导进去一片红叹号,你还得逐个节点对照文档改名。节点总数已经三千多个,官方文档翻起来也不轻。这类工具做的事很朴素:把「这个节点有哪些字段、哪些必填、能不能接下一个」变成结构化数据喂给模型,让它少猜。

怎么开始用

  1. 先定接入方式:图省事用官方托管面板注册拿 API Key,接进客户端即可,免费档每天 100 次工具调用;要完全自控就用 npx 本地跑
  2. 本地跑的命令很直白,设好 N8N_API_URL 和 N8N_API_KEY 两个环境变量,再按官方给的一段 MCP 配置写进客户端(Claude Code、Cursor 各有一份现成示例)
  3. 接上后先让它搜模板而不是搜节点:一句「找简单的 webhook 处理模板」,比让它从头拼五个节点快得多,也更少出错
  4. 拿到流程后务必在测试实例里跑一遍,先建副本再改。作者在 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

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。