Skip to main content
Glama
Sign In
deenesjakoruzh

n8n-workflow-builder-mcp

by ifmelate
GitHub
JavaScript
2
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue
Integrations

  • Supports integration with LangChain components in n8n workflows, offering special tools for connecting AI components and establishing connections between agent nodes, model nodes, and tool nodes.

  • Provides tools for building and manipulating n8n workflows through an AI-friendly interface, including creating new workflows, adding/editing nodes, managing connections between nodes, and discovering available node types.

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作为开发依赖项安装）

安装

  1. 克隆存储库：
    git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git cd n8n-workflow-builder-mcp
  2. 安装依赖项：
    npm install
  3. 构建 TypeScript 项目：
    npm run build
  4. 使 MCP 服务器脚本可执行（如果需要）：
    chmod +x dist/index.js

运行服务器

启动 MCP 服务器：

npm start

这将运行来自dist/index.js编译代码。

对于具有自动重建和重新启动更改的开发：

npm run dev

Cursor IDE 集成

有两种方法可以使用 Cursor 设置 MCP 服务器：

方法 1：使用光标设置 UI（推荐）

  1. 启动 Cursor IDE
  2. 前往“设置”>“功能”>“MCP 服务器”
  3. 单击“添加服务器”并提供dist/index.js文件的绝对路径（例如， /Users/yourname/n8n-workflow-builder-mcp/dist/index.js n8n-workflow-builder-mcp/dist/index.js）
  4. 确保服务器已启用
  5. 重新启动 Cursor IDE 以使更改生效

方法二：手动配置

  1. 确保.cursor目录存在：
    mkdir -p .cursor
  2. 创建 MCP 配置文件：
    cat > .cursor/mcp.json << 'EOF' { "mcpServers": { "n8n-workflow-builder": { "command": "node", "args": ["/absolute/path/to/n8n-workflow-builder-mcp/dist/index.js"] } } } EOF
    确保将/absolute/path/to替换为系统上的实际路径。
  3. 重新启动 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 协同工作时遇到问题，请尝试以下步骤：

  1. 重新启动 Cursor ：设置 MCP 配置后，完全关闭并重新启动 Cursor。
  2. 检查光标 MCP 设置：
    • 打开游标设置
    • 前往“功能”>“MCP 服务器”
    • 确保您的服务器已列出并启用
    • 如果已列出但不起作用，请尝试单击刷新按钮
  3. 检查服务器日志：在运行服务器的终端或“光标输出”面板中查找错误。从“输出”面板的下拉菜单中选择“光标 MCP”即可查看 MCP 特定的日志。
  4. 验证文件权限：确保dist/index.js文件具有执行权限。
  5. 检查端口冲突：如果其他 MCP 服务器正在运行，它们可能会发生冲突。请检查是否有其他进程正在使用相同的端口。
  6. 尝试全局安装：您可以尝试全局安装服务器，而不是使用本地路径：
    npm install -g n8n-workflow-builder-mcp
    然后更新.cursor/mcp.json文件以使用全局命令。

常见问题和解决方案

“无法创建客户端”

这通常发生在：

  • MCP 服务器未运行
  • Cursor 与服务器之间存在连接问题
  • 服务器在初始化期间崩溃

尝试：

  1. 运行测试脚本以确保服务器正常运行
  2. 检查服务器日志中的错误
  3. 重启游标

MCP 服务器未显示在 Cursor 中

如果出现以下情况，则可能会发生这种情况：

  • .cursor/mcp.json文件格式不正确
  • 光标未检测到配置更改

尝试：

  1. 验证.cursor/mcp.json文件的 JSON 格式
  2. 重启游标
  3. 在光标设置中手动选择服务器（如果它出现在那里）

MCP 服务器显示，但工具不可用

如果出现以下情况，则可能会发生这种情况：

  • 服务器未正确注册其工具
  • ListOfferings 请求/响应存在问题

尝试：

  1. 运行测试脚本来检查工具是否正确注册
  2. 点击 Cursor 中 MCP 服务器设置中的刷新按钮
  3. 检查服务器日志是否有任何错误

项目结构

  • /src ：主要源代码
  • /src/tools ：MCP 工具实现
  • /src/models ：数据模型
  • /src/utils ：实用程序函数
  • /src/middleware ：身份验证和中间件
  • /config ：配置文件
  • /tests ：测试文件
  • /workflow_nodes ：n8n 节点定义
  • /docs ：附加文档

贡献

欢迎贡献代码！欢迎提交 Pull 请求。

  1. 分叉存储库
  2. 创建你的功能分支（ git checkout -b feature/amazing-feature ）
  3. 提交您的更改（ git commit -m 'Add some amazing feature' ）
  4. 推送到分支（ git push origin feature/amazing-feature ）
  5. 打开拉取请求

执照

正在申请许可证 - 需要获得 n8n 团队的确认

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Tools

View all tools

n8n-工作流构建器-mcp

  1. 演示视频：
    1. 实施现状
    2. 主要特点
    3. 先决条件
    4. 安装
    5. 运行服务器
    6. Cursor IDE 集成
    7. 可用的 MCP 工具
    8. 光标集成故障排除
    9. 常见问题和解决方案
    10. 项目结构
    11. 贡献
    12. 执照

Related MCP Servers

  • n8n MCP Server

    lowprofix
    -
    security
    F
    license
    -
    quality
    A 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

  • mcp-n8n-builder

    spences10
    A
    security
    A
    license
    A
    quality
    🪄 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 -
    10
    29
    21
    TypeScript
    MIT License
    • Linux

View all related MCP servers

New MCP Servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ifmelate/n8n-workflow-builder-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server