一、项目介绍

用 n8n 搭自动化，最费劲的是“手拖节点、连错线、参数填错”：一个 IF 节点的双输出路由、addConnection 的四参数语法，稍微疏忽就逻辑错乱。你想用 AI 把工作流搭起来并自检，却被节点细节缠住。
n8n-mcp 是一个 MCP 服务器：把 n8n 的节点查询、工作流构建与校验能力暴露给 Claude Desktop / Claude Code / Cursor / Windsurf，让 AI 替你搭工作流，并做四级校验与自动修复。

二、项目基本信息

信息项详情
项目名称N8n-MCP
GitHub地址https://github.com/czlonkowski/n8n-mcp
项目描述A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you
作者czlonkowski
开源协议MIT License
开源状态公开
LanguagesTypeScript
支持平台Windows / macOS / Linux
最后更新2026-10-27

三、核心优势

  • 节点级查询与可视化构建
  • 四级校验：minimal / full / workflow / post-deploy
  • 自带自动修复常见错误
  • 支持真实模板示例，少走弯路
  • 大幅减少连接与表达式错误

四、适用场景

适合用 n8n 做自动化、希望用 AI 加速搭建与排错、降低手工连线出错率的用户。

五、安装教程

当前最新版本 v2.99.2。按下方命令安装（如遇网络问题可切换镜像源或代理）：

# 在任意 MCP 兼容客户端的 mcp 配置中以 npx 方式添加并启动 n8n-mcp
npx -y n8n-mcp
# 启动后客户端即可调用 n8n 节点查询与工作流构建工具

常见报错：依赖缺失时先升级运行环境（Node、Python、Go、JDK 等）到项目要求版本；网络超时多为镜像或代理问题，可重试或换源。权限类报错请确认已登录对应平台账号。

六、使用示例

下面是一段可直接参考的真实示例：

# 构建前快速校验节点必填字段
validate_node({nodeType, config, mode: 'minimal'})
# 完整校验并尝试自动修复
validate_node({nodeType, config, mode: 'full', profile: 'runtime'})
# 部署后复核工作流
n8n_validate_workflow({id})

七、常见问题

问：必须装 n8n 吗？答：是的，MCP 操作的是你已有的 n8n 实例。问：支持哪些客户端？答：任何 MCP 兼容的 AI 工具。

八、总结

N8n-MCP 用一个清晰的设计，把把第三方能力安全收拢到统一控制面这件反复劳动变成了可复用、可维护的能力。它不追求大而全，而是把核心痛点解决得足够扎实——这正是日常开发与团队落地时最需要的那种工具。如果你也在被同类问题困扰，不妨按上面的安装与使用步骤试一试，把它接进自己的工作流。