N8n-MCP:AI 助手可搜索和构建 n8n 工作流
n8n-MCP 是一个模型上下文协议(MCP)服务器,使 AI 助手能够访问 n8n 工作流自动化平台的知识。它提供了对 1,650 多个节点的结构化访问,包括属性、操作、文档和模板库。支持自托管和免费云服务,并提供了详细的 Claude 项目设置指南和验证策略。
n8n-MCP 是一个模型上下文协议(MCP)服务器,它充当 n8n 工作流自动化平台与 AI 模型之间的桥梁,使 AI 助手能够有效理解和操作 n8n 节点。该项目提供结构化访问,涵盖 1,650 个节点(820 个核心节点 + 830 个社区节点,其中 741 个已验证)、99% 的节点属性详细模式、63.6% 的节点操作覆盖率、87% 的官方文档覆盖率(包括 AI 节点)、265 个具有完整文档的 AI 工具变体、156 个从流行模板中提取的排名配置、2,352 个工作流模板(99.96% 的 AI 元数据覆盖率)以及可搜索的社区节点集成。
快速开始:最快的方式是通过 dashboard.n8n-mcp.com 使用免费云服务,每天有 100 次工具调用,无需安装配置。只需注册并获取 API 密钥即可连接 MCP 客户端。如果需要自托管,项目提供了 npx、Docker、Railway 和本地安装选项的详细指南。
n8n 集成:用户可以通过 MCP 客户端工具节点进行本地测试,使用 Docker Compose 进行生产部署,或在 Hetzner、AWS 等云平台上部署,还提供了排错和安全最佳实践。
IDE 连接:n8n-MCP 支持多种 AI 驱动的 IDE 和工具,包括 Claude Code、Visual Studio Code(GitHub Copilot)、Cursor、Windsurf、Codex 和 Antigravity,每个都有详细的集成指南。
Claude 项目设置:为了获得最佳效果,项目提供了增强的系统指令,强调静默执行、并行操作、模板优先、多级验证(从 minimal 到 full 再到 validate_workflow),并警告永远不要信任默认参数,因为默认值是运行时失败的首要原因。
验证策略:分为四个级别:快速检查(minimal 模式)、综合验证(full 模式带修复)、构建后完整验证(工作流、连接、表达式)以及部署后验证(包括自动修复和监控)。此外,支持批量操作,例如使用 n8n_update_partial_workflow 在一次调用中同时更新多个节点。
项目还包含了重要的安全警告:切勿直接使用 AI 编辑生产工作流,应始终先复制工作流、在开发环境中测试、导出备份,并在部署前验证所有更改。