AI导哈

n8n工作流自动化管理工具

n8n MCP Server是一个针对n8n工作流的自动化管理工具，通过自动修复、验证和版本控制等功能，确保工作流的最佳实践和高效运行。

  • by PageLines
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 PageLines/n8n-mcp

使用说明

n8n MCP服务器

固执己见的 n8n的工作流自动化。实施最佳实践，自动修复问题，并防止错误。

为什么选择MCP？

问题： 当您更新一个字段时，其他n8n MCP会替换整个节点。更改消息？丢失您的频道ID、身份验证设置和其他所有内容。没有撤消。他们捆绑了70MB的节点文档，你可以在谷歌上搜索。

该MCP固执己见：

  • 补丁，而非替换 -更新一个字段，保留其他所有字段
  • 自动清理 -每次创建/更新都会自动验证、自动修复和格式化
  • 自动快照 -每个突变都会先保存一个版本。始终具有回滚功能。
  • 节点类型验证 -在无效节点类型达到n8n之前，使用建议阻止它们
  • 表达式验证 -渔获物 $json 重新排序时中断的引用、循环deps、缺失节点
  • 执行公约 -snake_case命名，显式引用，建议使用env变量
  • 轻量级 -~1500行，零运行时依赖关系
此MCP 其他
更新节点 保留未触及的参数 丢失它们
创建/更新后 自动验证、自动修复、格式化 手动清理
无效的节点类型 使用建议阻止 API错误
突变前 自动保存版本 希望您已备份
表达式验证 语法、引用、循环deps 基本
大小 约1500个LOC 10k+LOC，70MB SQLite

设置

添加到MCP客户端配置中：

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@pagelines/n8n-mcp"],
      "env": {
        "N8N_API_URL": "https://your-n8n.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

无需安装步骤，npx可以处理。

参考

工具

类别 工具
工作流程 list get create update delete activate deactivate execute
执行 list get
验证 validate autofix format
发现 node_types_list
版本 list get save rollback diff stats

强制执行的意见

这些规则会被检查并自动修复 workflow_create 和 workflow_update:

规则 严重性 自动修复
snake_case命名 警告 是
显式引用($('node') 不 $json) 警告 是
AI结构化输出设置 警告 是
节点类型无效 错误 已阻止
硬编码秘密 信息 否
孤立节点 警告 否
表达式语法 错误 否
循环引用 错误 否

配置

变量 默认值 描述
N8N_API_URL 必需 n8n实例URL
N8N_API_KEY 必需的 API密钥
N8N_MCP_VERSIONS true 启用版本控制
N8N_MCP_MAX_VERSIONS 20 每个工作流的最大快照数

文档

许可证

麻省理工学院- 页面行数

相关 MCP