n8n 工作流设计器
一个带有REST API接口的服务器，用于以编程方式创建和管理n8n工作流，支持工作流的创建、验证和导出。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"n8n-workflow-builder": {
"args": [
"@makafeli/n8n-workflow-builder"
],
"command": "npx",
"env": {
"N8N_API_KEY": "your-api-key-here",
"N8N_HOST": "http://localhost:5678"
}
}
}
}该服务需要配置环境变量：N8N_API_KEY、N8N_HOST
可用工具 （10 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_workflows
List all workflows from n8n
该工具无需必填参数，直接调用即可
create_workflow 3 个参数 需填 1 项
Create a new workflow in n8n
必填参数：nodes
get_workflow 1 个参数 需填 1 项
Get a workflow by ID
必填参数：id
update_workflow 3 个参数 需填 2 项
Update an existing workflow
必填参数：id、nodes
delete_workflow 1 个参数 需填 1 项
Delete a workflow by ID
必填参数：id
activate_workflow 1 个参数 需填 1 项
Activate a workflow by ID
必填参数：id
deactivate_workflow 1 个参数 需填 1 项
Deactivate a workflow by ID
必填参数：id
list_executions 6 个参数
List all executions from n8n with optional filters
该工具无需必填参数，直接调用即可
get_execution 2 个参数 需填 1 项
Get details of a specific execution by ID
必填参数：id
delete_execution 1 个参数 需填 1 项
Delete an execution by ID
必填参数：id
服务介绍
n8n 工作流构建器 MCP 服务器
该项目提供了一个用于管理 n8n 工作流的 MCP 服务器。它通过一组定义好的工具提供了列出、创建、更新、删除、激活和停用工作流的功能。
重要提示：
此版本仅支持使用 npm 进行包管理和运行服务器。（将在未来的更新中重新引入对 npx 的支持。）
要求
- Node.js（推荐 v14+）
- npm
详细的安装指南
1. 克隆仓库
从您喜欢的源克隆仓库。例如：
git clone https://github.com/makafeli/n8n-workflow-builder.git
然后，导航到项目目录：
cd /root/n8n-workflow-builder
2. 安装依赖项
使用 npm 安装必要的依赖项：
npm install
该命令将根据 package.json 文件中的定义下载并安装所有必需的包。
3. 构建和测试
为了进行测试并将服务器上线，请使用以下命令：
-
构建项目：
这会编译 TypeScript 文件并在build目录中生成可执行的 JavaScript。npm run build -
启动 MCP 服务器：
使用以下命令启动服务器：npm start
服务器将通过 stdio 启动。您可以通过控制台查看确认服务器已正确启动的消息。
4. 部署
为了测试目的并将服务器上线，请使用上面提到的构建和启动命令。目前推荐的方法是基本工作流程（安装、构建、启动）。
5. 额外配置
服务器配置通过 cline_mcp_settings.json 文件进行管理。请确保以下环境变量设置正确：
N8N_HOST：您的 n8n API 主机 URL。N8N_API_KEY：您的 n8n API 密钥。
cline_mcp_settings.json 中的示例配置：
{
"n8n-workflow-builder": {
"command": "node",
"args": ["/root/n8n-workflow-builder/build/index.js"],
"env": {
"N8N_HOST": "https://n8n.io/api/v1/",
"N8N_API_KEY": "YOUR_N8N_API_KEY_HERE"
},
"disabled": false,
"alwaysAllow": [
"create_workflow",
"create_workflow_and_activate",
"update_workflow",
"activate_workflow",
"deactivate_workflow",
"get_workflow",
"delete_workflow"
],
"autoApprove": []
}
}
可用功能
MCP 工具
服务器中定义了以下工具，您可以通过您的 MCP 客户端访问这些工具：
工作流管理
- list_workflows：列出 n8n 中的所有工作流。
- create_workflow：在 n8n 中创建新的工作流。
- get_workflow：按 ID 检索工作流。
- update_workflow：更新现有工作流。
- delete_workflow：按 ID 删除工作流。
- activate_workflow：按 ID 激活工作流。
- deactivate_workflow：按 ID 停用工作流。
执行管理
- list_executions：列出所有工作流执行，可选过滤器。
- get_execution：按 ID 检索特定执行的详细信息。
- delete_execution：按 ID 删除执行。
MCP 资源
服务器还提供了以下资源，以便更高效地访问上下文：
静态资源
- /workflows：n8n 实例中所有可用的工作流列表
- /execution-stats：关于工作流执行的摘要统计信息
动态资源模板
- /workflows/{id}: 关于特定工作流的详细信息
- /executions/{id}: 关于特定执行的详细信息
故障排除
- 确保您使用的是 npm（此版本不支持 npx）。
- 如果遇到任何问题，尝试清理构建目录并重新构建：
npm run clean && npm run build - 确认
cline_mcp_settings.json中的环境变量是正确的。
未来增强
- 重新引入 npx 支持。
- 增加工具和工作流功能。
- 进一步增强部署和扩展功能。
许可证
本项目采用 MIT 许可证。
