n8n-workflow-builder

🚀 n8n 工作流 服务器 一款出色的 MCP 服务器，帮助您直接从构建、优化和调试工作流！ 🎯 **最新版本：** [v1.23.1](releases/v1.23.1.md) (2026-03 - 关键错误修复版本 🐛 ## 🌟 功能 ### 🧠 AI 驱动的工作 - **智能节点建议**: 只需描述您的内容，服务器就会建议完美的节点 - **器**: 从自然语言生成完整的工作流结构 - **最佳实践**: 了解 n8n 的最佳实践，并常见的错误 ### 🔍 工作流分析和调试 -流分析器**: 扫描工作流中的问题和 - **错误调试器**: 帮助您理解和修复错误 - **安全检查器**: 查找凭证和其他安全问题 ### 📊 工作流完整 CRUD） - **列表和筛选**: 展示所有工作和信息 详细信息**: 每个工作详细信息 - **执行跟踪**: 查看过去的执行情况和错误 -流创建**: 从头使用模板创建新的 - **工作流 智能合并更新 - 更改名称、修改节点设置 - ✨ **新增**: 智能节点合并数据丢失（v1.13.2） - ⚠️ 注意：`active` 和 `tags` 只读的，只能在 n UI 中更改 工作流删除**: 安全地删除/归档工作v1.14.0） ### ⚡执行和监控 - **手动触发**: 直接从 Claude 启动工作流（仅限手动/ 触发器） - **自定义输入数据**: 向工作流传递动态数据 - **执行详情**: 检索每次执行的完整节点输入/输出数据 - **执行历史**: 过去所有执行的列表及其状态 ### 🔄 会话状态和上下文管理 - **活动工作流跟踪**: 自动跟踪您当前正在处理的工作流 - **会话历史**: 记录您的所有操作（分析、执行、更新等） - **最近工作流**: 快速访问您最近的 10 个工作流 - **持久化状态**: 上下文在 Claude 对话之间 - **智能上下文**: 通过“当前”或“上一个工作流”而不是 ID 来引用工作流 ### ✅ 工作流验证和质量保证 - **部署前验证**: 部署工作流前的综合检查 - **模式验证**: 确保工作流结构正确（必需字段、类型等） - **语义验证**: 检查逻辑规则（触发节点、连接、重复项） - **参数验证**: 节点特定的参数检查（Webhook、HTTP、数据库等） - **安全检查**: 检测硬编码凭证、缺少 - **最佳实践**: 警告默认名称、缺少错误处理、复杂性 ### 🤖 AI 反馈和错误分析 **智能错误分析**: 分析失败的执行情况并原因 - **模式识别**: 检测常见的失败身份验证、网络、数据、SQL、速率限制） - **AI 友好型反馈**: 为生成工作流代理提供结构化指导 - **修复示例**: 错误代码与正确代码的比较 - **改进建议**: 节点特定的修复失败建议 - **学习循环**:代理从错误中学习并生成更好的工作流 📚 知识库 - **节点百科**: 所有8n 节点的详细解释 - **用例和示例**: 每个节点类型的实用- **配置提示**: 如何优化配置每个节点 ### 🔐 安全审计和治理（新增！） - **硬编码秘密检测**: 查找 API 密钥、密码、令牌、AWS 密钥、私JWT、数据库凭证 - **11 种秘密类型**: 检测 AWS 密钥、GitHub 令OpenAI 密钥、Slack 令牌、数据库 URL 等 - **熵分析**: 使用香农高熵秘密（加密/编码数据） 身份验证审计**: 检查缺少/弱身份验证、不安全的基本身份验证 - **暴露分析**: 确定公共 Webhook、数据泄露、PII 暴露B 配置错误 - **安全评分**: 0-100 分，风险级别（关键、高、中、低、优秀） - **合规验证**: 检查工作流是否符合基本、严格或企业标准 - **详细报告**: Markdown/Text 报告，包含发现、建议和补救- **优先级发现**: 仅获取高严重性问题进行快速分类 ### 🔬 语义工作流- **深度逻辑分析**: 超越模式验证流语义 - **12 种反模式检查**: HTTP 重试、循环完成、时区配置、IF 路径、Webhook 安全、无限循环、凭证、N 查询、速率限制、数据验证等 - **LLM 友好型修复**: 为 AI 代理提供即用的代码修复 - **严重性级别**:、高、中、低优先级 - **详细解释**: 每个问题的影响以及为什么重要 - **安全扫描**: 使用正则检测硬编码凭证 - **性能分析**: 确定 N+1 查询等瓶颈 - **格式化报告**: 结构化输出，优化 AI 消费 ### 🎯 模板库和 AI 推荐 - **10+ 预建模板**: 常见用例的即用模板 - **AI 驱动**: 根据获取智能模板建议 - **智能相关性 高级算法将模板与您的需求匹配（70% 准确率） - **类别浏览**: 按类别（API、报告、集成等）组织的模板 难度级别**: 初级、中级和高级模板 - **全文搜索**: 跨名称、描述、标签搜索 - **模板详情**: 完整的实施指南，包含预估时间和节点结构 ### 💭 意图元数据和 AI 上下文（新增！） - **“原因”文档**: 将推理、假设和风险每个节点 - **AI 上下文连续 LLM 记住节点在迭代之间的原因 - **5 个意图字段**: 原因、假设、风险、替代、依赖 - **覆盖率分析**: 跟踪具有数据的节点 - **AI 生成的建议记录的节点获取意图模板 - **工作流理解**: 更快速地理解现有工作流 - **学习循环**: AI 代理从过去的决策中### 🔄 执行感知反馈环（新增！） - **实时监控**: 监控工作流执行情况并获取即时错误反馈 - **错误简化**: 为代理简化复杂的 n8n 错误 - **上下文 获取完整的错误上下文（节点、输入、输出、错误详情） - **模式分析**: 跨多次执行分析错误模式 - **成功率跟踪**: 监控工作流的可靠性随时间的变化 - **修复建议**: 针对失败节点的特定建议 - **LLM 优化输出**: 为 AI 消费设计的结构化反馈 ### 📊 偏移检测和性能下降分析（新增**主动质量监控，检测工作流性能下降于未然** #### 一般偏移检测 - **成功率偏移**: 检测工作流成功率下降 >- **性能偏移**: 确定执行时间增加% - **新错误模式**: 查找以前错误类型 - **错误频率偏移**: 检测现有错误率的 2 倍以上增加 - **变更点检测**: 精确定位偏移开始的时间 - **渐进式与突发性分析**: 将变更分类为渐进式性能下降或突发性故障 #### - **模式偏移**: API 响应结构缺少字段、类型变更、空值率增加） 速率限制偏移**: 429 错误、吞吐、配额接近- **数据质量偏移**: 空值、格式违规、完整性下降 #### 智能分析 - **根本原因检测**: 10+ 基于证据的根本原因（API 速率限制、身份验证变更、模式变更等） - **置信度评分**: 0.0-0 置适用于所有分析结果 - **统计 基线（前 30%）与当前（后 30%）周期分析 - **证据 跟踪支持每个发现的具体指标 #### 可 - **节点特定建议**: 每个受影响节点的具体- **严重性分组**:、警告和信息修复 - **即插**: 即用修复代码建议 - **测试建议**: 分步测试指南 - **置信度评分**: 按置信度级别（85-95%修复 #### 现实用例 ✅ **商变更**: 检测 API 变更身份验证或速率限制 ✅ **性能下降**: 在 SLA 违规之前发现外部服务减速 ✅ **凭证过期**: 确定过期令牌的身份验证失败 数据质量问题**: 跟踪增加空值违规 ✅ **速率限制问题**: 尽接近配额限制 **需要**: 20+以进行可靠的偏移检测 ### 📖 可解释性层（新增！） - **综合 自动、审计准备好的工作流文档 - ****: 解释工作流为何存在，并具有（10 个领域） - **数据流 从源 → 转换 → 目标的数据完整 - **依赖关系映射**: 映射内部 + 25+ 外部服务（Slack、Stripe 等） - **风险评估**: 5（数据丢失、安全、性能、可用性、性） - **缓解计划**: 具有置信度评分的优先、可行建议 - **多**: Markdown（文档）、JSON（API）、控制台） - **AI 原生**: 为 LLM设计，具有结构化、一致的输出 配置**: 即时适用于任何 n8n ### 🔮 变更模拟和审批系统！） - **Terraform预览**: 类terraform plan` 的 n8n 工作流前查看变更 - **变更检测**: 自动识别关键变更（触发器连接变更） - **多维影响分析**: 在 5 个维度（数据流、执行、依赖关系、触发器、下分析影响 - **风险评分**: 0-10 风险评分，风险级别（低、中、高、严重） - **干运行验证**: 在应用变更前验证结构、语义和性能 - **审批工作流**: 创建、审查、批准/拒绝变更请求，带有完整审计跟踪 变更历史**:时间戳和审查者的所有工作流变更历史 - **颜色编码输出**: 🔴 变更、🟡 结构变更、🟢 - **性能估计**: 预测执行时间使用量、复杂度 -**: 基于的可行建议 ### 🎯 智能模板系统.0（新增！） - **基于意图的匹配**: 描述您的目标 → 获取智能模板不是关键词搜索！） - **多源**: 官方 n8n 模板、GitHub 仓库、私有仓库 - **意图提取**:模板中提取目的、假设、风险、 - **触发评分**: 惩触发器类型（当您需要计划时使用） - **模板适配**: 现代化2 模板 → 2025 就绪（占位符、凭证、错误处理） - **来源跟踪**: 信任评分、成功率、使用统计信息可靠性 - **语义理解**: “AI 匹配 “机器“电报” “通知” - **透明匹配**: 显示模板为何匹配的详细解释 ### 📦 节系统（新增！） 工作流的学习，发现可用的 n8n 节点，无需 API 智能发现 - **自动学习您的工作流，以发现您使用的所有节点类型 **现实模式**: 从实时工作流中提取实际参数（不是文档！） - **使用洞察**: 跟踪节点流行度、参数类型、凭证需求 - **SQLite 持久性**: 知识保存到 `~/.n8n-mcp/node_discovery.db` - **零配置**: 适用于所有 n8n 版本 - 无需 API！ #### 智能推荐 - **基于任务的建议**: “发送 Slack 消息” → Telegram、Gmail、chatTrigger 高级评分**: 精确关键词（5 分）、同义词（2.5 分）、参数（+1 分）、流行度（+3 分最大值） - **双向同义词**: 40+ 映射（slack↔telegram、excel↔sheets、database↔postgres） - **原因生成**: “匹配：发送、消息” 或 “类似：slack” 解释节点 - **类别分类**: ⚡ 触发器、📊 数据源、🔄 转换、📬 通知、🌐 http、🔀 逻辑、🔧 实用工具 #### 智能搜索和模式 - **关键词搜索**:查找节点，带有类别图标 - **详细模式**: 获取参数名称、类型、凭证、使用计数 - **参数类型推断**: 从真实数据中学习类型（字符串、数字、布尔值、对象、数组） - **使用统计**: 查看哪些节点在您的工作流中最受欢迎 #### 性能 - **快速发现**: 100 个工作流 ≈ 15 秒 - **快速推荐**: < 200 毫秒获取 100 个已发现的节点 - **内存缓存**: 数据库加载后可进行即时查询 **4 个新工具**: `discover_nodes`、`get_node_schema`、`search_nodes`、`recommend_nodes_for_task` ### 🔄 迁移引擎 - **自动兼容性检查**: 检测工作流中已弃用的节点和参数 - **智能迁移规则**: 7 条内置规则，适用于常见 n8n 节点（HTTP、Postgres、Slack 等） - **版本检测**: 确定与 n8n 0.180.0 至 2.2.6 的兼容性问题 - **n8n 2.0+ 支持**: 检测已删除的 Start 节点、禁用的 ExecuteCommand/LocalFileTrigger、Code 节点安全更改 - **干运行模式**: 在应用迁移前预览更改 - **批量操作**: 一次检查多个工作流，并附有汇总统计信息 - **严重性级别**: 按影响优先修复（严重、高、中、低） - **安全转换**: 验证迁移以防止数据丢失 - **详细报告**: 完整的迁移前后比较和日志 ## 🎯 用例 ### 1. 从工作流理念到完成结构 ``` 您： “我需要一个工作流，每天 9 点从 Postgres DB 获取数据， 计算指标，并通过 Slack 发送报告” Claude + MCP: 生成完整的工作流结构，包括： - 调度触发器（每天 9 点） - Postgres 节点（带有查询示例） - 函数节点（指标计算） - 设置节点（报告格式化） - Slack 节点（最佳实践） ``` ### 2. 工作流调试 ``` 您： “我的工作流抛出‘超时已超过’错误” Claude + MCP: 分析并建议： - 增加超时设置 - 添加重试逻辑 - 分批处理数据 - 检查外部服务性能 ``` ### 3. 工作流优化 ``` 您： “分析我的工作流‘每日报告生成器’” Claude + MCP: 发现： - 3 个硬编码的 API 密钥（安全问题！） - 工作流可以分成 2 个子工作流 - 缺少错误处理 点 “HTTP 请求” 应重命名 ``` ### 4. 智能模板推荐（新增！您： “我需要根据事件发生时向多个通道发送通知” Claude + MCP推荐： 1. 多通道通知系统（ 匹配）- 初学者 - 适用于系统警报和状态更新 - Slack、Telegram 和 Email -时间：20 分钟 2. 全处理程序（62% 匹配）- - 捕获工作流错误并提醒团队 - 包括日志记录和通知功能 - 预估时间：25 分钟模板 'notification_system' 开始！ ``` ### 偏移检测（新增！） ``` “我的工作流上个月运行正常，但失败。发生了什么？” Claude + MCP: 使用 detect_workflow_drift 分析执行历史： 📊 检测到偏移 - 严重性：严重 指标比较： - 成功率：95% → 62% (-33%) - 平均：1200ms → 1850ms%) 检测到的模式： 🔴 新的错误模式： “429 速率限制超过” （2 周前出现） ⚠️ 性能偏移： 响应时间在 10 天内逐渐增加一倍 下一步： 使用 get_drift_root_详细分析 ``` ``` 您： “什么这种偏移？” Claude + MCP: 使用 get_drift_root_cause： 根本原因： api_rate_limit_introduced 置信度：85% 证据： - 速率限制错误出现在以前没有的地方 - 错误 14 天前开始出现 - 仅影响调用外部 API 的 HTTP 请求节点 推荐操作： 添加请求限流或实施指数级退避 ``` ``` 您： “我如何修复它？” Claude + MCP: 使用 get_drift_fix_suggestions： 🔧 建议的修复： 1. 在请求之间添加延迟（节点：获取用户数据） - 添加具有 1-2 秒延迟的“等待”节点 - 置信度：85% 2. 实现具有指数级退避的重试逻辑 - 使用“HTTP 请求”重试设置：3 次尝试，指数级延迟 - 置信度：90% 测试建议： 使用速率限制的 API 进行测试 ✅ 监控更改后的执行时间 ✅ 验证错误率降至 5% 以下 ``` ### 6. 迁移引擎（新功能！） ``` 你： "检查我的工作流是否存在兼容性问题" 克劳德 + MCP： 使用 check_workflow_compatibility ✅ 兼容性检查完成 状态： 已废弃（包含已废弃的功能） 发现的问题： 1. [高] HTTP 请求节点（v2）- 参数 'url' 已废弃，请使用 'requestUrl' 2. [高] HTTP 请求节点（v2）- 参数 'method' 已废弃，请使用 'requestMethod' 3. [中] Slack 节点（v1）- 消息格式化结构在 v2 中已更改 4. [低] 设置节点（v1）- 新的选项结构在 v2 中 建议： 运行迁移以更新节点到最新版本 ``` ``` 你： "展示如果我迁移这个工作流会发生什么变化" 克劳德 + MCP： 使用 get_migration_preview 迁移预览： 节点： 发送 API 请求（HTTP 请求 v2 → v3） 更改： - 参数.url → 参数.requestUrl - 参数.method → 参数.requestMethod - 认证移动到凭证字段 节点： 通知团队（Slack v1 → v2） 更改： - 参数.message.text → 参数.text - 参数.message.attachments → 参数.blocks - 默认启用 Markdown 总更改： 2 个节点，6 个参数 风险级别： 中等 ``` ``` 你： "先用 dry-run 迁移工作流" 克劳德 + MCP： 使用 migrate_workflow（dry_run=true） dry-run 迁移完成 ✅ 应用的更改（仅预览）： ✓ HTTP 请求 v2 → v3（发送 API 请求） ✓ Slack v1 → v2（通知团队） ✓ 设置 v1 → v2（格式化数据） 验证： 通过 所有连接保留 未检测到数据丢失 准备应用？ 运行时不使用 dry_run=true ``` ``` 你： "应用迁移" 克劳德 + MCP： 使用 migrate_workflow 迁移应用成功！ ✅ 更新的节点： ✓ 发送 API 请求（HTTP 请求 v3） ✓ 通知团队（Slack v2） ✓ 格式化数据（设置 v2） 工作流已更新并保存 建议测试执行 ``` ### 7. 工作流可解释性（新功能！） ``` 你： "我需要为 SOC 2 审计记录 '支付处理' 工作流" 克劳德 + MCP： 使用 explain_workflow，格式为 Markdown # 工作流解释：支付处理 ## 执行摘要 目的： 自动响应电子商务操作事件 | 业务领域： 电子商务 | 类型： event_driven | 数据从 Webhook 流向 8 个转换 → PostgreSQL，Slack，电子邮件 | 依赖于 4 个外部服务 | 风险级别： 中等 ## 目的分析 **主要目的**： 自动响应电子商务操作事件 **业务领域**： 电子商务 **工作流类型**： event_driven **置信度**： 85% ## 数据流 输入源： 订单 Webhook 转换： 验证订单 → 计算总金额 → 检查库存 输出目标： 保存订单（PostgreSQL），通知团队（Slack），电子邮件客户 ## 依赖关系 外部服务： - PostgreSQL（数据库） - Slack（消息） - SendGrid（电子邮件） ⚠️ 单点故障： - 数据库用于 2 个节点 - 高关键凭证影响 2 个节点 ## 风险评估 **总体风险级别**： 中等（评分：4.8/10） 🔴 数据丢失风险： - [高] 数据库操作无事务管理（保存订单） 🔐 安全风险： - [高] 使用 3 个高关键凭证 ⚠️ 性能风险： - [中] 外部 API 调用无速率限制（检查库存） 🛠️ 缓解计划： 1. [高] 添加错误处理和重试逻辑 2. [高] 确保凭证定期轮换 3. [中] 为 API 调用添加速率限制 适用于： 审计文档、上岗培训、风险评估 ``` ``` 你： "如果 api.stripe.com 宕机，会影响哪些工作流？" 克劳德 + MCP： 为所有工作流使用 map_dependencies 受影响的工作流（3 个）： 1. 支付处理 - 节点： 处理支付、退款 - 严重程度： 关键 2. 订阅管理器 - 节点： 创建订阅、取消 - 严重程度： 高 3. 发票生成器 - 节点： 获取客户、创建发票 - 严重程度： 中等 总影响： 3 个工作流，6 个节点受影响 建议： 计划维护窗口并通知利益相关者 ``` ### 8. 变更模拟和安全部署（新功能！） ``` 你： "我想将支付处理工作流更新为使用新的 Stripe API v2" 克劳德 + MCP： 使用 simulate_workflow_changes ================================================================================ 工作流变更计划 ================================================================================ 总更改： 5 风险级别： 中等 🔴 破坏性更改 -------------------------------------------------------------------------------- • [高] 1 个连接被移除 影响： 数据流将被中断 建议： 验证移除的连接是有意的 🟡 结构更改 -------------------------------------------------------------------------------- ~ 修改节点：'处理支付' 参数.apiVersion： v1 → v2 参数.endpoint： /charges → /payment_intents 凭证： stripe_v1 → stripe_v2 🟢 数据流更改 -------------------------------------------------------------------------------- 无数据流更改 ⚠️ 影响评估 -------------------------------------------------------------------------------- 总体风险评分： 4.5/10（中等） 依赖影响： • 需要 1 个新凭证： stripe_v2 • 添加 1 个新外部服务： Stripe API v2 下游影响： • 更改将影响 2 个工作流，调用此工作流 - 订单处理（调用此工作流） - 退款处理程序（调用此工作流） 💡 建议 -------------------------------------------------------------------------------- 🔑 在部署前配置 1 个新凭证 🌐 验证与新外部服务的连接： Stripe API v2 ⚙️ 审查和更新 2 个下游工作流 🧪 运行端到端测试以验证执行行为 ================================================================================ ⚠️ 警告： 此更改包含破坏性更改！ 仔细审查后再应用。 ================================================================================ DRY-RUN 模拟 ================================================================================ ✅ 模拟通过 - 工作流有效 **预计性能：** - 节点数： 8 - 持续时间： ~4.0s - 内存： ~80MB - 复杂度： 中等 你： "为团队审查创建变更请求" 克劳德 + MCP： 使用 create_change_request ✅ 变更请求已创建 **请求 ID**： a3b4c5d6 **工作流**： 支付处理（8PyhAN1U4JvF5eSb） **状态**： 待处理 **请求者**： dev.team **原因**： 迁移到 Stripe API v2 以实现 PSD2 合规性 **创建时间**： 2024-12-16T10:30:00Z [团队负责人审查和批准] 你： "显示此工作流的变更历史" 克劳德 + MCP： 使用 get_change_history # 变更历史 **总请求**： 12 状态摘要： - 已应用： 10 - 已拒绝： 1 - 待处理： 1 最近的变更： ✅ 请求 a3b4c5d6 - 状态： 已批准 - 请求者： dev.team - 原因： 迁移到 Stripe API v2 - 审查者： team.lead - 评论： 已批准 - 在预发布环境中测试 - 审查时间： 2024-12-16T14:20:00Z ✔️ 请求 x1y2z3a4 - 状态： 已应用 - 请求者： dev.team - 原因： 为支付处理添加重试逻辑 - 审查者： senior.dev - 应用时间： 2024-12-10T09:15:00Z ``` ### 可解释性（新！） ``` 你： "解释 '支付处理' 工作流程" Claude 使用：explain_workflow → 完整的文档：目的、数据流、依赖关系、风险 → 可用格式：markdown（默认）、json、text ``` ``` 你： "工作流程 abc-123 的目的是什么？" Claude 使用：get_workflow_purpose → 业务领域、工作流程类型、触发器描述、预期结果 ``` ``` 你： "跟踪此工作流程中的数据流" Claude 使用：trace_data_flow → 输入源、转换、输出目标、关键路径 ``` ``` 你： "显示此工作流程的所有依赖关系" Claude 使用：map_dependencies → 内部工作流程、外部服务、凭证、单点故障 ``` ``` 你： "评估此工作流程中的风险" Claude 使用：analyze_workflow_risks → 5 类风险及缓解计划 → 总体风险评分和级别 ``` ## 🧠 知识库 服务器了解以下节点类别： ### 触发器 - **Webhook**: API 端点、外部集成 - **Schedule**: Cron 作业、周期性任务 - **Manual**: 测试、手动干预 ### 逻辑节点 - **IF**: 条件分支 - **Switch**: 多路分支 - **Merge**: 合并数据流 - **Code**: 自定义 JavaScript/Python ### 数据操作 - **HTTP 请求**: API 调用 - **Set**: 数据转换 - **Function**: 复杂数据处理 ### 存储 - **Postgres**: 关系型数据库 - **Redis**: 缓存、会话存储 ### 集成 - **Slack**: 消息和通知 - **Telegram**: 机器人集成 - **Gmail**: 邮件自动化 ## 🛠️ 高级功能 ### 自定义模板 服务器带有预定义的模板： - `api_endpoint`: 简单的 REST API - `scheduled_report`: 每日/每小时报告 - `data_sync`: 数据库同步 ### 安全检查 - 查找硬编码凭证 - 警告缺少身份验证 - 检查不安全模式 ### 性能分析 - 计算工作流程复杂性 - 检测超大工作流程 - 建议拆分以提高可维护性 ## 💾 状态文件 服务器将会话状态存储在 `~/.n8n_workflow_builder_state.json` 中。该文件包含： - 当前活动的工作流程 - 最近的工作流程（最近 10 个） - 会话历史（最近 50 次操作） - 时间戳 这允许服务器在 Claude 会话之间保持上下文！ **重置状态：** 使用 `clear_session_state` 工具或手动删除文件： ```bash rm ~/.n8n_workflow_builder_state.json ``` ## 🐛 故障排除 ### 服务器无法启动 ```bash # 检查 Python 版本（应为 3.11+） python --version # 重新安装依赖项 pip install -r requirements.txt --force-reinstall # 检查 .env cat .env # 应包含 N8N_API_URL 和 N8N_API_KEY ``` ### "身份验证失败" - 检查您的 API 密钥是否正确 - 转到 n8n 设置 > API 并创建新的密钥 - 确保密钥中没有空格 ### "连接被拒绝" - 您的 n8n 实例是否可访问？ - 检查：`curl https://your-n8n-instance.com/healthz` - 防火墙/VPN 可能正在阻止 ### Claude 桌面版无法识别服务器 1. 完全退出 Claude（也包括后台！） 2. 检查配置文件（有效 JSON？） 3. 路径绝对（非相对！） 4. 重新启动 Claude 5. 在 Claude 中检查：设置 > 开发者 > MCP 服务器 ## 💡 专业提示 ### 1. 工作流程命名 - **始终** 重命名节点！ "HTTP 请求 1" 不好，"获取用户数据" 好 - 为类别使用前缀： "[API] 获取用户", "[DB] 插入记录" ### 2. 错误处理 - **始终** 为关键工作流程添加错误处理 - 使用 "错误触发器" 节点进行全局错误处理 - 在 Slack/Telegram 中记录错误以进行监控 ### 3. 测试 - 始终使用 "手动触发器" 而不是直接 Webhook - 使用 "固定数据" 进行一致的测试 - 分割生产/开发工作流程 ### 4. 性能 - 在可能的情况下批量处理 API 调用 - 使用 Redis 进行缓存 - 避免过多的顺序 HTTP 请求 ### 5. 安全 - **绝不** 硬编码 API 密钥 - 始终使用凭证 - 启用 Webhook 身份验证 - 仅存储加密的敏感数据 ## 🔄 状态管理深入探讨 有关状态管理和上下文跟踪系统的详细信息，请参阅： - **[状态管理文档](docs/STATE_MANAGEMENT.md)** - 完整指南 - **[状态文件示例](docs/state_example.json)** - 状态文件示例 **快速摘要：** - 自动跟踪活动工作流程 - 记住最近 10 个工作流程 - 记录最近 50 次操作并带有时间戳 - 在 Claude 会话之间持久化 - 存储在 `~/.n8n_workflow_builder_state.json` 中 ## ✅ 工作流程验证深入探讨 有关验证系统的详细信息，请参阅： - **[验证文档](docs/VALIDATION.md)** - 完整验证指南 **快速摘要：** - 3 层验证：模式、语义、参数 - 30+ 验证规则 - 安全检查（凭证、身份验证、SQL 注入） - 节点特定参数验证 - 全面的错误/警告报告 - 部署前验证 ## 🤖 AI 反馈深入探讨 有关 AI 反馈系统的详细信息，请参阅： - **[AI 反馈文档](docs/AI_FEEDBACK.md)** - 完整 AI 反馈指南 **快速摘要：** - 智能错误模式识别 - 根原因识别（6+ 错误类型） - AI 友好结构化反馈 - 修复示例（错误 vs. 正确） - 工作流程改进建议 - AI 代理的学习循环 ## 🔒 RBAC 和多租户安全深入探讨 有关安全系统的详细信息，请参阅： - **[RBAC 和安全文档](docs/RBAC_SECURITY.md)** - 完整的企业安全指南 **快速摘要：** - 5 种角色类型（管理员、开发者、操作员、查看者、审计员） - 20+ 粒度权限 - 多租户隔离（每个租户的独立工作流程） - 关键操作的审批工作流程 - 全面的审计日志（SOC2、ISO27001、GDPR 就绪） - 不能批准自己的请求（职责分离） ### RBAC 使用示例 ``` 你： "显示给我 RBAC 状态" Claude 使用：rbac_get_status → 显示用户、角色、租户、待批审批、审计日志 你： "将用户 'bob' 添加为租户 'acme-corp' 中的开发者" Claude 使用：rbac_add_user → 创建具有开发者权限的用户 你： "检查 bob 是否可以删除工作流程" Claude 使用：rbac_check_permission → 显示开发者角色是否具有 workflow.delete 权限 你： "Bob 想要删除工作流程 abc-123，创建审批请求" Claude 使用：rbac_create_approval_request → 创建待批审批请求 你： "以 alice 的身份批准请求 approval-123" Claude 使用：rbac_approve_request → 管理员批准，操作可以继续 你： "显示最近 24 小时的审计日志" Claude 使用：rbac_get_audit_log → 显示所有具有时间戳的安全事件 ``` ### 企业功能 ✅ **基于角色的访问控制** - 5 种内置角色，带有预定义权限 - 操作前进行粒度权限检查 - 按用户分配角色 ✅ **多租户隔离** - 租户之间的数据完全隔离 - 每个租户的工作流程、用户、审计日志 - 基于租户的访问控制 ✅ **审批工作流程** - 4 个关键操作需要审批 - 不能批准自己的请求 - 完整的审批决策审计跟踪 ✅ **审计日志** - 存储最近 500 个安全事件 - 按用户、操作、时间戳过滤 - 符合性准备（SOC2、ISO27001、GDPR） ✅ **安全设计** - 最小特权原则 - 职责分离 - 不可变审计日志 - 无自我审批 ## 🔄 更新和扩展 ### 将自定义节点添加到知识库 编辑 `server.py` 并扩展 `NODE_KNOWLEDGE`： ```python NODE_KNOWLEDGE["integrations"]["notion"] = { "name": "Notion", "desc": "Notion 数据库集成", "use_cases": ["知识库", "项目管理"], "best_practices": ["使用数据库 ID", "批量更新"] } ``` ### 创建自定义模板 编辑 `server.py` 中的 `WORKFLOW_TEMPLATES`： ```python WORKFLOW_TEMPLATES["my_template"] = { "name": "我的自定义模板", "nodes": [...], "connections": "custom" } ``` ## 📊 API 参考 服务器使用官方的 n8n REST API： - 基本 URL：`https://your-n8n-instance.com/api/v1` - 文档：https://docs.n8n.io/api/ 已使用的端点： - `GET /workflows` - 列出工作流程 - `GET /workflows/{id}` - 获取工作流程详细信息 - `POST /workflows` - 创建工作流程 - `PUT /workflows/{id}` - 更新工作流程 - `POST /workflows/{id}/run` - 执行工作流程 - `GET /executions` - 获取执行历史 - `GET /executions/{id}` - 获取执行详细信息 ## 🤝 贡献 想法？问题？PR 欢迎！ 🎉 ## 📊 漂移检测深入探讨 有关漂移检测系统的详细信息，请参阅： - **[漂移检测文档](releases/v1.10.0.md)** - 完整的漂移检测指南 **快速摘要：** - 时间比较：基线（前 30%）与当前（后 30%）执行周期 - 4 种漂移模式：成功率、性能、新错误、错误频率 - 变更点检测：查找指标何时显著变化 - 7 种根原因类型：速率限制、依赖项故障、模式变化、凭证、资源耗尽、逻辑错误、配置漂移 - 置信度评分：0.0-1.0 分析所有内容 - 可行性修复：错误类型特定并带有测试建议 ## 💭 意图元数据深入探讨 有关意图元数据系统的详细信息，请参阅： - **[意图元数据文档](releases/v1.8.0.md)** - 完整的意图系统指南 **快速摘要：** - 每个工作流程节点的 "为什么" 文档 - 5 个字段：原因、假设、风险、替代、依赖 - 跨迭代的 AI 上下文连续性 - 覆盖率分析和建议 - 存储在节点元数据（n8n 原生字段）中 ## 🔄 执行监控深入探讨 有关执行监控的详细信息，请参阅： - **[执行监控文档](releases/v1.9.0.md)** - 完整的监控指南 **快速摘要：** - 实时执行监视和错误检测 - 为 AI 消费简化错误 - 上下文提取（节点、输入、输出、错误） - 跨多个执行的模式分析 - 带有置信度评分的修复建议 ## 🔄 迁移引擎深入探讨 有关迁移系统的详细信息，请参阅： - **[迁移引擎文档](docs/MIGRATION.md)** - 完整的迁移指南 **快速摘要：** - 自动节点兼容性检查 - 节点版本升级的基于规则的转换 - 7 条内置迁移规则（HTTP 请求、Postgres、Slack、Function、Webhook、Set） - 安全预览的干运行模式 - 跨所有工作流程的批量兼容性检查 - 基于严重性的问题优先级（关键、高、中、低） - 验证迁移以防止数据丢失 ## 📖 可解释性层深入探讨 有关可解释性层的详细信息，请参阅： - **[可解释性层文档](releases/v1.11.0.md)** - 完整的可解释性指南 **快速摘要：** - 自动、审计就绪的工作流程文档 - 具有业务领域分类的目的分析（10 个领域） - 完整的数据流跟踪（源 → 转换 → 接收器） - 依赖关系映射（内部工作流程 + 25+ 外部服务） - 5 类风险评估（数据丢失、安全、性能、可用性、合规性） - 多格式导出（Markdown/JSON/纯文本） - 零配置，适用于任何工作流程 ## 🔮 变更模拟和审批深入探讨 有关变更模拟和审批工作流程的详细信息，请参阅： - **[变更模拟文档](releases/v1.12.0.md)** - 完整的变更模拟指南 **快速摘要：** - Terraform 风格的工作流程变更预览（类似 `terraform plan`） - 变更检测（触发器删除、连接变更、输出节点） - 多维影响分析（5 个维度） - 风险评分算法（0-10 评分） - 干运行验证（结构 + 语义 + 性能） - 具有审计跟踪的审批工作流程 - 性能估计和建议 **6 个新的 MCP 工具：** 1. `simulate_workflow_changes` - 使用 terraform 风格的计划预览变更 2. `compare_workflows` - 工作流程并排比较 3. `analyze_change_impact` - 多维影响分析 4. `create_change_request` - 创建审批请求 5. `review_change_request` - 批准/拒绝变更 6. `get_change_history` - 查看工作流程变更历史 ## 🚀 智能模板系统 v2.0 有关模板系统的详细信息，请参阅： - **[模板系统文档](releases/v1.13.0.md)** - 完整的智能模板系统指南 **快速摘要：** - 多源模板适配器（n8n 官方、GitHub、本地文件） - 基于意图理解的 AI 驱动模板推荐 - 超越简单关键词的语义匹配 - 模板质量评分和排名 - 自动缓存和重复数据删除 - 无需配置 ## 📦 版本历史 请参阅 **[CHANGELOG.md](CHANGELOG.md)** 获取完整的版本历史和发行说明。 **最新版本**: [v1.22.1 - 完整的 n8n 2.2.6 节点覆盖](releases/v1.22.1.md) ### 最近版本 - **[v1.22.1](releases/v1.22.1.md)** - 完整的 61 个节点覆盖（2025 年 1 月） - **[v1.22.0](releases/v1.22.0.md)** - n8n 2.2.6 兼容性（2025 年 1 月） - **[v1.21.0](releases/v1.21.0.md)** - 版本跟踪系统（2024 年 12 月） - **[v1.20.0](releases/v1.20.0.md)** - 文档访问和节点替换（2024 年 12 月） ## 📁 示例工作流程 查看 **[examples/](examples/)** 目录中的即用示例工作流程： 1. **简单的 API 端点** - 带有 JSON 响应的基本 Webhook 2. **每日销售报告** - 调度 Postgres 查询 → Slack 通知 3. **用户注册 API** - 带有验证和错误处理的完整 CRUD 每个示例都包含： - ✅ 完整的工作流程 JSON - ✅ 文档和设置说明 - ✅ 最佳实践和安全提示 - ✅ SQL 模式和配置示例 **[浏览示例 →](examples/README.md)** ## 📝 许可证 MIT - 您可以随意操作！ ## 🙏 致谢 - 为优秀的 n8n 自动化而构建 🚀 - 由 Claude MCP 提供支持 ⚡ - 由 DevOps 工程师用 ❤️ 制作 --- **快乐自动化！** 🎊 如有疑问或问题：只需问 Claude！😉