czlonkowski/n8n-mcp

n8n‑MCP – 为 n8n 设计的「模型上下文协议」服务器

它是啥

• 一个轻量级 HTTP 服务，将 n8n 工作流自动化节点（约 2,400 个节点）的完整目录以 AI 模型（Claude、ChatGPT 等）可查询的结构化数据形式暴露出来。
• 可以将其视为 n8n 的可搜索知识库：节点名称、属性、操作、示例配置和文档均可通过一组明确定义的 API 调用获取。

为何重要

• 大型语言模型可以生成或编辑 n8n 工作流，但需要可靠且最新的节点信息。n8n‑MCP 提供了这些上下文，减少幻觉和损坏的工作流。
• 通过在 n8n 实例中集成 MCP 客户端节点，您可以让 AI 助手 发现模板、获取节点规格、验证配置，甚至自动部署工作流。

核心功能（如 README 所述）

功能	你能获得什么
节点目录	2,412 个节点（829 个核心，1,583 个社区）覆盖 99% 属性和 66% 操作。
文档	86% 的官方 n8n 文档，以及 AI 专用节点文档。
AI 就绪工具	267 个标记为“AI 能力”的节点变体。
真实世界示例	从热门社区模板中提取的 156 个排名配置。
模板库	2,352 个即用型工作流模板，每个均带有 AI 元数据注释。
搜索与检索	支持搜索节点、属性、模板和社区集成的工具，可按复杂度、受众、所需服务等进行过滤。
验证流水线	多阶段验证（minimal → full → 工作流级）在部署前捕获缺失参数。
管理 API	一旦通过 N8N_API_URL/N8N_API_KEY 指向您自己的 n8n 实例，即可通过程序化方式创建、更新、测试和删除工作流。
安全警告	强烈建议不要直接用 AI 编辑生产环境工作流；始终复制、测试并备份。

如何使用

1. 立即试用 – 主机化仪表板（dashboard.n8n-mcp.com）提供每日 100 次免费工具调用；只需注册并获取 API 密钥。
2. 自托管 – 项目提供 Docker 镜像、npx 启动器和 Railway 部署脚本，适合需要控制权或更高限制的用户。
3. 连接到 n8n – 在任意 n8n 工作流中添加 MCP Client Tool 节点，配置 API 密钥，即可调用 MCP 工具（如 search_nodes、get_node、validate_workflow）。
4. 与 AI IDE 集成 – 项目提供 Claude Code、VS Code（Copilot）、Cursor、Windsurf、Codex 和 Antigravity 的现成设置指南，让这些助手在后台调用 MCP 工具。
5. 部署工作流 – 通过 MCP 工具构建工作流后，可使用 n8n_create_workflow 推送到您的 n8n 实例，用 n8n_test_workflow 运行测试，并让服务器自动修复常见错误（n8n_autofix_workflow）。

典型的 AI 助手工作流

1. tools_documentation()          # 获取 MCP 背景信息
2. search_templates({task:'slack notification'})
3. get_template(id, {mode:'full'})
4. validate_workflow(workflow)
5. n8n_create_workflow(workflow)   # 部署到您的 n8n 实例

README 还详细列出了“Claude 项目设置”，包含强制静默并行执行和强制模板引用的系统指令。

安全与治理

• 通过禁用破坏性工具并使用只读 n8n API 密钥，可将服务器运行在 只读 模式，适用于受监管环境。
• 支持 Cloudflare Access，可将 n8n API 保护在零信任架构下。
• 详尽文档涵盖加固、隐私和遥测。

谁会受益

• 开发者：希望在无需手动查找节点规格的情况下，借助 AI 协助构建复杂自动化的人。
• 团队：希望向内部 LLM 助手提供经过筛选、可搜索的 n8n 知识库的人。
• AI 工具厂商：正在寻找可直接集成 n8n 功能的即用型协议的厂商。

---

总结：n8n‑MCP 是一个真正的、生产级的桥梁，将 n8n 节点生态系统转变为 AI 模型可用的机器可读知识源，具备搜索、验证和部署能力。