n8n-manager-mcp 是一个针对 n8n 工作流管理的 MCP（Model Context Protocol）服务器，作为 AI 助手（如 Claude Code、Claude Desktop、Cursor、Windsurf）与本地或远程 n8n 实例之间的本地优先、基于 stdio 的桥接工具。它属于 ellmos-ai 生态及 open-bricks 伞形项目的一部分。
【用途】 通过 AI 助手以自然语言完成 n8n 工作流的查看、创建、同步和管理，覆盖工作流的增删改查、多实例同步、执行历史检查等场景。
【主要能力】
- 提供 19 个工具，支持完整工作流管理：列出、创建、更新、删除、激活/停用工作流。
- 安全控制：只读模式、删除/更新前备份、本地恢复、审计日志。
- 多服务器支持：连接多个 n8n 实例（开发、预发布、生产），各实例 API 凭据隔离，配置可原子持久化。
- 跨服务器导出/导入工作流。
- 查看执行历史与状态。
- 内置节点目录，提供节点描述（n8n_describe_nodes），可离线即时获取节点模式，无需网络调用。
- 可选集成 n8n-workflow-manager（同系列项目）：提供历史记录与决策日志的只读接缝（n8n_manager_history），需配置 N8N_MCP_MANAGER_URL 启用；n8n_safety_status 报告该接缝的配置、可达性与管理器版本。
【使用方式】 作为 npm 包发布（n8n-manager-mcp）。安装后需将其添加到 claude_desktop_config.json 等 AI 助手配置中。配置完成后，可在 AI 助手中使用自然语言指令，例如：
- 添加 n8n 服务器：“Add my n8n server at http://localhost:5678 with API key abc123”
- 列出工作流：“Show me all workflows on my n8n server”
- 创建工作流：“Create an n8n workflow that triggers on a webhook, fetches data from an API, and sends a Slack message”
- 查看执行：“Show me the last 10 workflow executions” 服务器连接与安全设置保存在 ~/.n8n-manager-mcp/servers.json。备份存放于 ~/.n8n-manager-mcp/backups/，可通过备份工具列出/恢复。审计日志默认追加到 ~/.n8n-manager-mcp/audit.log。 安全默认值：backup_before_mutations 为 true（在更新、删除、激活/停用、覆盖恢复前保存工作流 JSON）；audit_log 为 true；read_only 为 false，可通过 n8n_set_safety_mode 或环境变量 N8N_MANAGER_READ_ONLY=1 开启，环境标志作为强制上限，开启后持久化设置和 n8n_set_safety_mode 均无法关闭只读模式。
【适用场景】
- 在 AI 编码助手环境中快速管理 n8n 自动化工作流。
- 需要连接多个 n8n 实例（开发、预发布、生产）并进行同步或导入导出的团队。
- 希望在无网络调用下查询节点模式（离线节点目录）。
- 需要审计、备份和安全只读控制的企业或自动化代理环境。
【限制与注意事项】
- 运行时要求 Node.js（GitHub Actions 测试覆盖 Node.js 20、22、24）。
- 管理器接缝为可选且只读；ID 为管理器 ID，非 n8n 实例 ID，服务器不猜测其映射关系；若管理器配置但不可达，工具会明确报错而非回退到 n8n 实例查询。
- 数值防护：工作流、执行、备份列表限制为 1 到 1000 的有限正整数（默认分别为 100、20、20）；连接 from_output/to_input 索引为 0 到 1000 的有限非负整数；无效值在访问任何 n8n API、文件系统或工作流数组前被拒绝。
- n8n_add_server 校验规则：URL 必须为 http 或 https 基础 URL，不含内嵌凭据、查询字符串或片段；API 密钥不得包含空白字符。默认服务器语义：首个服务器成为默认；不带 is_default 的更新保留现有标志；true 提升为默认；false 有意移除标志，之后默认查找回退到第一个已配置服务器。
- 管理器 API 默认无认证且仅限回环地址，非回环 URL 会在 n8n_safety_status 中被标记。
- 当前验证记录覆盖 Windows 本地和 GitHub Actions 上的 Ubuntu Linux；具体提交的本验证记录见 CHANGELOG.md。
- 项目以 MIT 许可证发布，无 copyleft/AGPL 依赖，无外部遥测。使用风险自负，不提供维护承诺、可用性保证、无错误保证或特定用途适用性保证。安全漏洞响应 SLA：48 小时内初次响应，5 个工作日内完成分诊，30 个日历日内交付协调安全补丁。
- 有关配置示例、完整工具列表及参数细节，原始资料未提供完整清单，暂未提供。