n8n-mcp 是一个面向 n8n 的 MCP（Model Context Protocol）服务器，由 AutomateLab-tech 开发，采用 MIT 许可证，要求 Node 20 或更高版本。它面向 Claude、Cursor 及其他 AI 智能体，提供工作流生成、静态检查（linting）、执行失败诊断以及驱动实时 n8n 实例的能力。
【用途与定位】 该项目定位为“调试优先、首次运行正确”的 n8n MCP 服务器。创建者在使用 n8n 过程中反复遇到 LLM 生成工作流 JSON 的失败：导入成功但运行时失败、AI Agent 集群连接类型错误、执行过程静默丢弃数据却难以定位。因此该服务器将 lint 可捕获的失败模式、生成器必须遵守的集群拓扑、以及智能体无法独立完成的诊断能力编码为工具。项目自述与其他 n8n MCP 服务器（如 czlonkowski/n8n-mcp）在广度上竞争不同，专注于调试与首次运行正确性。
【主要能力】
- workflow_generate：从自然语言生成 n8n 工作流 JSON，对 AI Agent 拓扑有明确约束，输出正确的 LangChain 集群，使用 ai_languageModel / ai_memory / ai_tool 连接（子节点向上连接到 agent，而非通过 main），可在 n8n 1.x 上干净导入。
- workflow_lint：捕获静默失败，包括已弃用节点类型（Function → Code、spreadsheetFile → convertToFile）、AI Agent 缺少语言模型、IF v1 schema、Webhook 缺少 webhookId、跨所有连接类型（不仅是 main）的断裂连接。
- execution_explain：核心功能。粘贴执行 JSON，返回逐节点发现：哪些节点返回 0 个条目、哪些存在未解析的 ={{ ... }} 表达式、带具体提示的错误消息。
- 5 个 REST 工具（需设置 N8N_API_URL + N8N_API_KEY）：列出、获取、创建、激活工作流，以及拉取执行记录，使 lint 和 explain 工具可针对实时工作流运行，而不仅是聊天中粘贴的 JSON。
- 配套 Agent Skill：教模型何时使用哪个工具以及在哪里加载更深入的上下文（拆分到 references/ 目录，避免提示膨胀）。
- v0.5.0 新增三个工具：workflow_diff、execution_replay、execution_timeline；lint 扩展 10 条新规则（速率限制、凭据漂移、表达式陈旧、代码沙箱、Webhook 测试路径、manualTrigger-in-active、DST 调度风险、disabled-but-wired、空 Set、HTTP 方法/正文不匹配）；新增运行时策略环境变量：N8N_MCP_READ_ONLY、N8N_MCP_DISABLED_TOOLS、N8N_MCP_ALLOWED_WORKFLOW_IDS、N8N_MCP_ALLOWED_TAGS；提供 DXT 包、Dockerfile 及 Render/Railway/Fly 部署配置。
- 工具命名采用点号表示法，形成可导航树：node.、workflow.、execution.*。每个工具声明 outputSchema（便于调用方类型检查响应）和 MCP annotations（只读/破坏性/幂等/开放世界提示）。
- 无状态工具（无需实时 n8n 实例）；实时实例工具（需要 N8N_API_URL + N8N_API_KEY 环境变量）。
【使用方式】
- 配置 MCP 主机：在 Cursor（~/.cursor/mcp.json）或 Claude Desktop（claude_desktop_config.json）中配置。env 块可选，4 个无状态工具无需它。API 密钥从 n8n 获取：Settings → API → Create API key。重启 MCP 主机后，12 个点号表示法工具（workflow.、node.、execution.*）出现在 MCP 面板中。
- Claude Desktop 一键安装：从 dxt/manifest.json 构建 .dxt 包（见 dxt/README.md）。
- Docker：docker build -t n8n-mcp . && docker run --rm -i -e N8N_API_URL=... -e N8N_API_KEY=... n8n-mcp
- Render：使用 render.yaml，点击 "New from Blueprint"。
- Railway：railway.toml，在仓库根目录运行 railway up。
- Fly.io：fly.toml，运行 fly launch --copy-config。
- GitHub Action：可在 CI/CD 流水线中 lint 工作流、诊断执行、生成工作流 JSON，详见 ACTION.md 和 GITHUB-ACTION-SETUP.md。
- 冒烟测试：npm run smoke 以 --smoke 标志启动服务器，列出已注册工具后退出，不绑定 stdio，适用于 CI 或首次运行检查。
- 示例：examples/ 目录含两个可直接导入的工作流：workflow-stripe-to-slack.json（Stripe webhook 分发到 Slack 和 Google Sheets）与 workflow-rss-to-discord.json（RSS 触发将新条目发到 Discord 频道），通过 n8n 的 Import from File 对话框导入。
- 使用示例：workflow_generate 可构建“Stripe webhook → Slack 消息 + Google Sheets 新行”；execution_explain 可分析“Slack 节点未触发的原因”，或接收工作流 JSON 进行 lint，结果可能为“未发现问题”。
【适用场景】 适合在 n8n 中开发、调试工作流的开发者与 AI 智能体，尤其适合需要快速定位执行失败、检查工作流导入后能否正确运行、以及在 CI/CD 中集成工作流 lint 与诊断的团队。运行时策略环境变量可用于将 MCP 交给初级智能体或接入面向客户的助手时进行约束。
【限制与缺失】
- 项目自述聚焦调试与首次运行正确性，广度不及部分其他 n8n MCP 服务器。
- v0.4.0 存在破坏性变更：工具从 n8n_*（下划线命名）重命名为点号表示法，需更新引用旧名称的提示、agent skills 或脚本。
- 实时实例工具需配置 N8N_API_URL 与 N8N_API_KEY 环境变量。
- 要求 Node 20 或更高版本。
- 资料未提供定价、收费或授权费用信息；许可为 MIT（见 LICENSE）。
- 资料未提供工具数量以外的性能指标、准确率或兼容性细节。
