-
securityA
license-
qualityA Model Context Protocol (MCP) server for programmatically creating and managing n8n workflows.
Last updated -
3
MIT License
n8n 工作流生成器 MCP
该项目提供了一个模型上下文协议 (MCP) 服务器，用于在 Cursor IDE 中构建和操作 n8n 工作流 JSON。这是一种只需在聊天中使用 AI 提示即可构建 n8n 工作流的方法。
演示视频：
实施现状
它目前处于早期开发阶段。基本上可以正常工作 - MCP 服务器会创建包含 n8n 工作流的 JSON 文件，您可以将其复制并粘贴到 n8n UI 中的工作流编辑器中。目前存在的问题：
- 有时LLM代理会在请求中输入错误的参数。我打算想办法解决这个问题。
- 有时节点之间的连接无法设置。我正在努力解决这个问题。
- 并非所有类型的节点都已检查正常工作。我正在努力解决这个问题。
- 初始提示确实很重要。如果提示不清楚，代理就会走错路。我打算想办法解决这个问题。
主要特点
- 工作流管理：以编程方式创建、更新和执行 n8n 工作流（执行尚未实现）
- 节点发现：探索可用的 n8n 节点及其功能
- 连接管理：在工作流节点之间创建连接
- AI 集成：用于在工作流���连接 AI 组件的特殊工具
- 人工智能友好界面：专为与人工智能代理交互而设计
先决条件
- Node.js（v14 或更高版本）
- Cursor IDE（v0.48 或更新版本）
- npm 或 yarn
- TypeScript 编译器（通过
npm install作为开发依赖项安装）
安装
- 克隆存储库：
- 安装依赖项：
- 构建 TypeScript 项目：
- 使 MCP 服务器脚本可执行（如果需要）：
运行服务器
启动 MCP 服务器：
这将运行来自dist/index.js编译代码。
对于具有自动重建和重新启动更改的开发：
Cursor IDE 集成
有两种方法可以使用 Cursor 设置 MCP 服务器：
方法 1：使用光标设置 UI（推荐）
- 启动 Cursor IDE
- 前往“设置”>“功能”>“MCP 服务器”
- 单击“添加服务器”并提供
dist/index.js文件的绝对路径（例如，/Users/yourname/n8n-workflow-builder-mcp/dist/index.jsn8n-workflow-builder-mcp/dist/index.js） - 确保服务器已启用
- 重新启动 Cursor IDE 以使更改生效
方法二：手动配置
- 确保
.cursor目录存在： - 创建 MCP 配置文件：确保将
/absolute/path/to替换为系统上的实际路径。 - 重新启动 Cursor IDE 以使更改生效
可用的 MCP 工具
该服务器提供了以下用于处理 n8n 工作流的工具：
| 工具名称 | 描述 | 关键参数 |
|---|---|---|
| 创建工作流 | 创建新的 n8n 工作流程 | workflow_name 、 workspace_dir |
| 列出工作流程 | 列出所有现有工作流程 | （无参数） |
| 获取工作流详细信息 | 获取有关特定工作流程的详细信息 | workflow_name |
| 添加节点 | 向工作流添加新节点 | workflow_name 、 node_type 、 position 、 parameters 、 node_name 、 typeVersion |
| 编辑节点 | 编辑工作流中的现有节点 | workflow_name 、 node_id 、 node_type 、 node_name 、 position 、 parameters |
| 删除节点 | 从工作流中删除节点 | workflow_name 、 node_id |
| 添加连接 | 在节点之间添加连接 | workflow_name 、 source_node_id 、 source_node_output_name 、 target_node_id 、 target_node_input_name |
| 添加AI连接 | 为 LangChain 节点添加 AI 连接 | workflow_name 、 agent_node_id 、 model_node_id 、 tool_node_ids |
| 列出可用节点 | 列出可用的节点类型并进行可选过滤 | search_term （可选） |
光标集成故障排除
如果您在让 MCP 服务器与 Cursor 协同工作时遇到问题，请尝试以下步骤：
- 重新启动 Cursor ：设置 MCP 配置后，完全关闭并重新启动 Cursor。
- 检查光标 MCP 设置：
- 打开游标设置
- 前往“功能”>“MCP 服务器”
- 确保您的服务器已列出并启用
- 如果已列出但不起作用，请尝试单击刷新按钮
- 检查服务器日志：在运行服务器的终端或“光标输出”面板中查找错误。从“输出”面板的下拉菜单中选择“光标 MCP”即可查看 MCP 特定的日志。
- 验证文件权限：确保
dist/index.js文件具有执行权限。 - 检查端口冲突：如果其他 MCP 服务器正在运行，它们可能会发生冲突。请检查是否有其他进程正在使用相同的端口。
- 尝试全局安装：您可以尝试全局安装服务器，而不是使用本地路径：然后更新
.cursor/mcp.json文件以使用全局命令。
常见问题和解决方案
“无法创建客户端”
这通常发生在：
- MCP 服务器未运行
- Cursor 与服务器之间存在连接问题
- 服务器在初始化期间崩溃
尝试：
- 运行测试脚本以确保服务器正常运行
- 检查服务器日志中的错误
- 重启游标
MCP 服务器未显示在 Cursor 中
如果出现以下情况，则可能会发生这种情况：
.cursor/mcp.json文件格式不正确- 光标未检测到配置更改
尝试：
- 验证
.cursor/mcp.json文件的 JSON 格式 - 重启游标
- 在光标设置中手动选择服务器（如果它出现在那里）
MCP 服务器已显示，但工具不可用
如果出现以下情况，则可能会发生这种情况：
- 服务器未正确注册其工具
- ListOfferings 请求/响应存在问题
尝试：
- 运行测试脚本来检查工具是否正确注册
- 点击 Cursor 中 MCP 服务器设置中的刷新按钮
- 检查服务器日志是否有任何错误
项目结构
/src：主要源代码/src/tools：MCP 工具实现/src/models：数据模型/src/utils：实用程序函数/src/middleware：身份验证和中间件/config：配置文件/tests：测试文件/workflow_nodes：n8n 节点定义/docs：附加文档
贡献
欢迎贡献代码！欢迎提交 Pull 请求。
- 分叉存储库
- 创建你的功能分支（
git checkout -b feature/amazing-feature） - 提交您的更改（
git commit -m 'Add some amazing feature'） - 推送到分支（
git push origin feature/amazing-feature） - 打开拉取请求
执照
正在申请许可证 - 需要获得 n8n 团队的确认
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
n8n-工作流构建器-mcp
Related MCP Servers
- -securityFlicense-qualityA Master Control Program server that provides workflow validation tools and best practices for n8n automation projects, including workflow management, NextJS integration, and API access.Last updated -TypeScript
- AsecurityAlicenseAquality🪄 MCP server for programmatic creation and management of n8n workflows. Enables AI assistants to build, modify, and manage workflows without direct user intervention through a comprehensive set of tools and resources for interacting with n8n's REST API.Last updated -102746TypeScriptMIT License
- Rust