n8n-mcp

让 AI 帮你自动搭建 n8n 工作流，告别手动拖拽

n8n-mcp 是一个将 n8n 工作流自动化能力接入 AI 编程助手的 MCP（模型上下文协议）服务器。它解决了在 Claude Desktop、Claude Code、Windsurf、Cursor 等 AI 工具中无法直接操作 n8n 的问题，让 AI 能根据自然语言指令自动创建、管理和执行 n8n 工作流。核心能力包括：通过 MCP 协议暴露 n8n 的 API，支持创建、更新、启用/禁用工作流，管理执行记录，以及获取工作流状态等。用户无需手动拖拽节点，只需向 AI 描述需求，AI 即可生成完整的工作流配置并部署到 n8n 实例。该项目基于 TypeScript 开发，安装配置简单，兼容主流 AI 编程环境，显著降低了 n8n 的使用门槛，提升了自动化流程的开发效率。

开源 unknown 自动化工作流

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 22974

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类自动化工作流

开发团队czlonkowski

所属国家

官网地址https://www.n8n-mcp.com

GitHubhttps://github.com/czlonkowski/n8n-mcp

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型mcp,mcp-server,n8n,workflows

GitHub 星标★ 22974

30天Star增速

HF 下载量

上线时间2025-06-07 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-10

浏览次数7

使用教程

难度：入门约 10 分钟部署方式：云服务 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

一个支持 MCP 的 AI 客户端（Claude Desktop、Claude Code、Windsurf、Cursor 等）
云托管方式：在 dashboard.n8n-mcp.com 注册账号并获取 API Key
自托管方式：README 指向自托管指南，支持 npx、Docker、Railway、本地安装
如需使用 n8n 管理工具，需要 n8n 实例的 API URL 与 API Key

安装与启动步骤

1注册云服务

打开 dashboard.n8n-mcp.com 注册账号，免费额度 100 次工具调用/天，注册后获取 API Key。
2连接 MCP 客户端

把拿到的 API Key 填入 Claude Desktop、Claude Code、Cursor 等客户端的 MCP 配置中完成连接。
3自托管方案（可选）

不想用云服务时，按官方自托管指南选择 npx、Docker、Railway 或本地安装方式。
4配置 n8n 管理工具

README 说明 21 个 n8n 管理工具需要配置 N8N_API_URL 和 N8N_API_KEY 才能使用。

5只读部署（可选）

治理敏感环境可禁用写入/破坏性工具，实现只读部署，避免 AI 误改工作流。

DISABLED_TOOLS=n8n_create_workflow,n8n_update_full_workflow,n8n_update_partial_workflow,n8n_delete_workflow,n8n_autofix_workflow,n8n_deploy_template,n8n_test_workflow,n8n_manage_credentials,n8n_manage_datatable

关键配置

配置项	必填	说明	示例
`N8N_API_URL`	否	n8n 实例地址，配置后才能使用管理类工具	`https://your-n8n-instance.com`
`N8N_API_KEY`	否	n8n 实例的 API 密钥，配合 API URL 使用	`your-n8n-api-key`
`DISABLED_TOOLS`	否	按工具名整体禁用写入/破坏性工具	`n8n_create_workflow,n8n_delete_workflow`
`DISABLED_TOOL_OPERATIONS`	否	只禁用工具内的破坏性操作，保留 list/get 读操作	`n8n_executions:delete;n8n_manage_folders:create,rename,move,`

如何确认成功

在 AI 客户端中调用一次 MCP 工具（如查看工作流执行记录）能正常返回结果，即表示连接成功。

常见问题

Q：不想自己部署怎么办？

A：直接用官方云服务 dashboard.n8n-mcp.com，免费额度 100 次工具调用/天，注册拿到 API Key 后连接 MCP 客户端即可。

Q：为什么管理类工具不可用？

A：这 21 个 n8n 管理工具需要配置 N8N_API_URL 和 N8N_API_KEY 才能启用，缺失时只能查节点文档。

Q：如何让 AI 只读不改？

A：用 DISABLED_TOOLS 整体禁用写入类工具，或用 DISABLED_TOOL_OPERATIONS 只屏蔽破坏性操作、保留读取。

Q：自托管有哪些安装方式？

A：README 指向自托管指南 docs/SELF_HOSTING.md，涵盖 npx、Docker、Railway 和本地安装四种方式。

Q：如何进一步提升安全性？

A：只读部署时建议配合只读的 n8n API Key（在 n8n 的 Settings → API 中生成）。

注意事项

本 README 节选未给出具体的 npx/Docker 安装命令，实际命令需查看官方自托管指南，切勿照搬猜测的包名与参数。
DISABLED_TOOLS 与 DISABLED_TOOL_OPERATIONS 可组合使用：前者整体移除工具，后者仅屏蔽工具内的写入操作。
n8n_test_workflow 的 auto、trigger、pinned、direct 四种方式都会真实运行工作流，只读部署时需一并禁用。

核心亮点

支持 Claude、Cursor 等主流 AI 工具，即插即用
自然语言直接生成完整工作流，大幅提升效率
基于 MCP 标准协议，扩展性好，社区活跃

不足之处

依赖 n8n 实例，需额外部署和维护
复杂工作流的生成准确性可能有限

适用场景

在 AI 编程助手中快速创建自动化流程
批量管理 n8n 工作流，如启停、更新
通过对话调试和优化现有工作流配置

替代项目

n8n、Zapier MCP、Make MCP

项目介绍

n8n-mcp 是自动化工作流领域的开源项目，由 czlonkowski 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（22,974）位列前 3%，在自动化工作流分类的 511 个项目里位列前 7%。

近 41 天，它的 GitHub 星标从 22,671 增加到 22,974，净增 303。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：在AI编程助手中快速创建自动化流程。同类可对比的替代方案包括 n8n、Zapier MCP、Make MCP。

上一篇：pbottleRPA

下一篇：n8nworkflows.xyz