综合介绍
n8n-mcp-server 是一个开源项目,托管在 GitHub 上,由 Leonard Sellem 开发。它是一个 MCP(Model Context Protocol)服务工具,专门用来与 n8n 工作流交互。n8n 是一个自动化工作流平台,而这个工具通过 MCP 协议,让 AI 助手可以直接操作 n8n。你可以用它创建、运行和管理 n8n 工作流。它适合想通过 AI 简化自动化任务的人,比如开发者或团队。项目在 2025 年 3 月还有更新,说明它维护得不错。
功能列表
- 通过 MCP 协议连接 n8n,让 AI 助手直接控制工作流。
- 支持创建和修改 n8n 工作流。
- 可以运行 n8n 工作流并查看结果。
- 用环境变量配置 n8n 的连接信息。
- 开源设计,代码可以自由调整。
使用帮助
安装步骤
要用 n8n-mcp-server,你得先把它装好。以下是具体步骤:
- 准备工具
确保电脑上有 Node.js(建议版本 18 或更高)。你还需要一个运行中的 n8n 实例,并且打开了 API 功能。去 n8n 设置里找 API 密钥。 - 下载项目
在终端输入:
git clone https://github.com/leonardsellem/n8n-mcp-server.git
然后进入目录:
cd n8n-mcp-server
- 安装依赖
运行这条命令:
npm install
它会装好项目需要的文件。
- 设置环境变量
复制示例文件:
cp .env.example .env
打开 .env
文件,填入 n8n 的信息,比如:
N8N_API_URL=http://localhost:5678/api/v1
N8N_API_KEY=你的n8n密钥
DEBUG=false
N8N_API_URL
是 n8n 的地址。N8N_API_KEY
是密钥。DEBUG
设为true
可以看更多日志。
- 编译代码
输入:
npm run build
这会把代码转成可运行的文件。
- 启动服务
运行:
npm start
服务就启动了,AI 助手可以通过标准输入输出跟它沟通。
如何使用核心功能
装好后,n8n-mcp-server 就成了一个 MCP 服务。它的主要作用是让 AI 跟 n8n 工作流互动。以下是操作方法:
- 连接到 AI
你得把这个服务加到 AI 平台。比如在支持 MCP 的工具里,编辑配置文件,加入:
{
"mcpServers": {
"n8n": {
"command": "n8n-mcp-server",
"env": {
"N8N_API_URL": "你的n8n地址",
"N8N_API_KEY": "你的密钥"
}
}
}
}
保存后,AI 就能找到这个服务。
- 创建工作流
你可以对 AI 说:“帮我在 n8n 里建一个工作流,每天发邮件给我。” AI 会通过 MCP 服务,把请求发给 n8n,自动创建。 - 运行工作流
说:“运行我的邮件工作流。” 服务会告诉 n8n 执行任务,然后返回结果,比如“任务完成”或“出错了”。 - 检查状态
问:“我的工作流跑得怎么样了?” 服务会查 n8n 的状态,告诉你具体情况。 - 调试问题
如果用着不对劲,把.env
里的DEBUG
改成true
,重启服务,就能看到详细日志。开发者还能改代码加功能。
小提示
- n8n 如果跑在本地,地址通常是
http://localhost:5678/api/v1
。 - 密钥要保密,别随便给人看。
- 可以用 Docker 跑 n8n,配置方法跟
.env
差不多。
应用场景
- 定时任务
你可以用它做一个工作流,每天查天气然后发短信提醒。AI 通过服务直接搞定。 - 数据处理
在公司里,可以用它自动整理销售数据,生成表格发到群里。AI 操作,省时省力。 - 测试开发
开发者可以用它测试 AI 和 n8n 的配合,改代码试新想法。
QA
- 我得会编程吗?
不会也行,只要会用命令行装东西就够了。但改功能得懂 JavaScript。 - 这个服务有啥特别的?
它让 AI 能直接管 n8n 工作流,不用你手动点来点去。 - 能连几个 n8n?
随便几个。每个服务配一个 n8n 地址,跑多个实例就行。