n8n-pro-mcp 是一个面向自托管 n8n 实例的 Model Context Protocol（MCP）服务器，旨在让 MCP 客户端（如 Claude Code、Claude Desktop、Cursor 或任意其他 MCP 客户端）以工具化方式管理 n8n 实例。它通过官方 n8n 公共 API v1 连接实例，共提供 51 个工具，覆盖工作流、执行记录、标签、凭据、变量、项目、用户、安全审计、源码控制与健康监控。
主要能力与特色：
-
队列模式一等支持。针对以 EXECUTIONS_MODE=queue 运行、包含 workers 与 webhook processors 的实例，提供 list_running_executions（实时队列视图）、get_execution_stats（按工作流统计成功率与平均耗时）以及 check_health（healthz、readiness、API 认证检查）。N8N_WEBHOOK_BASE_URL 可让 webhook 调用指向专用 webhook processors。
-
完整 API v1 覆盖。除常规的工作流与执行记录 CRUD 外，还涵盖标签、变量、项目、用户、源码控制与跨项目转移。
-
内置离线校验。validate_workflow_json 无需任何 API 调用即可检查结构、连接完整性、孤立节点、表达式语法、webhook .body 访问、Code 节点返回格式以及硬编码密钥。create_workflow 和 update_workflow 会自动运行该校验，并拒绝无效的负载。
-
安全的部分更新。update_workflow 会先获取当前工作流，仅合并传入字段并剥离只读字段，避免因发送不完整的 PUT 而丢失节点。
-
按名称设置标签。set_workflow_tags 接受标签名称并自动创建缺失的标签，无需手动处理 ID。
-
原始 API 不具备的运维组合能力。包括 summarize_execution_error（仅返回失败节点与错误，而非庞大的 JSON 转储）、prune_executions（支持 dry run 的批量清理）、wait_for_execution（轮询直到终态）、clone_workflow 以及 set_workflows_active_by_tag（基于标签的熔断开关）。
使用方式：当从源码运行时，可将 .env.example 复制为项目根目录下的 .env——服务器从包根目录而非工作目录加载它。当通过 npx 安装时，应改由 MCP 客户端配置设置变量（npx 缓存中的 .env 文件不会被读取）。配置可写入 .claude/settings.json 或 .mcp.json，Claude Desktop 对应 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows），Cursor 则在 .cursor/mcp.json 中使用相同的 JSON 配置块。
工具分组（共 51 个）：执行记录（10 个）；标签类包括 list_tags、create_tag、update_tag、delete_tag、get_workflow_tags、set_workflow_tags（按名称，自动创建缺失标签）；凭据（4 个）包括 create_credential、delete_credential、get_credential_schema、transfer_credential，密钥为只写，n8n API 永不返回凭据数据；变量类包括 list_variables、create_variable、update_variable、delete_variable（需许可功能）；项目类包括 list_projects、create_project、update_project、delete_project，以及成员管理 add_user_to_project、remove_user_from_project、change_user_project_role（需许可功能）；用户类包括 list_users、get_user、create_user（邀请）、delete_user、change_user_role。
队列模式使用场景：在 EXECUTIONS_MODE=queue（main + workers + Redis）下，先用 check_health 确认主进程与数据库运行正常；用 list_running_executions 查看当前实际在途的执行，若列表持续增长且 startedAt 较旧，说明 workers 饥饿或卡住；用 get_execution_stats 找出失败或缓慢的工作流（按成功率最差优先排序）；用 run_webhook 配合指向 webhook processors 的 N8N_WEBHOOK_BASE_URL 端到端测试生产摄取路径。
前提与限制：需要一个启用了公共 API 的 n8n 实例（未设置 N8N_PUBLIC_API_DISABLED）以及 API 密钥；变量、项目和源码控制工具需要 n8n 对应的许可功能。CI（GitHub Actions）在每次 push 与 PR 时运行构建、测试与 npm audit。项目由 Helbert Paranhos 在 Strat Academy 创建，采用 MIT 许可。