AC

alicankiraz1/cursor-n8n-builder

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

59 stars 12 forks 质量 71 趋势 13MIT

Cursor n8n 工作流程构建器 MCP

概览

一个模型上下文协议(MCP)服务器,使Cursor IDE中的AI助手能够通过n8n REST API管理n8n的工作流。 - : 创建、更新、删除和列表工作流程 - : 激活和停用工作流程 - : 查看执行历史和详细信息 - : 通过webhook URL触发工作流程 - : 内置AI助手帮助系统 - : 常见的n8n节点类型和配置 - : 带指数退去的自动重试 创建或编辑 ~/.cursor/mcp.json 进行全局配置: 1. 登录你的n8n实例 2.进入> 3.点击4。复制生成的密钥 n8n_get_node_info工具提供了以下常见节点的信息: - : webhook, scheduleTrigger, manualTrigger - : httpRequest, code, set, if, merge - : splitInBatches, respondToWebhook 服务器具备强大的错误处理功能: - : 失败请求最多重试3次 - : 重试间延迟增加 - : 错误消息包含解决提示 - : API 请求超时30秒

概述(AI 翻译)

一个模型上下文协议(MCP)服务器,使Cursor IDE中的AI助手能够通过n8n REST API管理n8n的工作流。

特色

  • 工作流程管理:创建、更新、删除和列出工作流程
  • 工作流程激活:激活和停用工作流程
  • 执行管理:查看执行历史和详细信息
  • **Webhook 触发:通过 webhook URL 触发工作流程
  • 自我文档:内置的AI助手帮助系统
  • 节点信息:常见的n8n节点类型和配置
  • 错误处理:带指数回退的自动重试

快速启动

安装

或者使用安装脚本:

手动配置

创建或编辑 ~/.cursor/mcp.json 以实现全局配置:

获取n8n API密钥

  1. 登录你的n8n实例
  2. 进入设置 > API
  3. 点击 Create API Key
  4. 复制生成的密钥

可用工具

文档与帮助

工具 描述
n8n_tools_help 获取使用指南和文档
n8n_get_node_info 获取常见n8n节点的信息

工作流程管理

工具 描述

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Cursor n8n MCP Server

A Model Context Protocol (MCP) server that enables AI assistants in Cursor IDE to manage n8n workflows through the n8n REST API.

Features

  • Workflow Management: Create, update, delete, and list workflows
  • Workflow Activation: Activate and deactivate workflows
  • Execution Management: View execution history and details
  • Webhook Triggering: Trigger workflows via webhook URLs
  • Self-Documentation: Built-in help system for AI assistants
  • Node Information: Common n8n node types and configurations
  • Error Handling: Automatic retry with exponential backoff

Quick Start

Installation

git clone https://github.com/alicankiraz1/cursor-n8n-mcp.git
cd cursor-n8n-mcp

npm install
npm run build

node dist/index.js setup

Or use the install script:

./install.sh

Manual Configuration

Create or edit ~/.cursor/mcp.json for global configuration:

{
  "mcpServers": {
    "cursor-n8n-mcp": {
      "command": "node",
      "args": ["/path/to/cursor-n8n-mcp/dist/index.js"],
      "env": {
        "MCP_MODE": "stdio",
        "LOG_LEVEL": "error",
        "N8N_API_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-api-key"
      }
    }
  }
}

Getting n8n API Key

  1. Log in to your n8n instance
  2. Go to Settings > API
  3. Click Create API Key
  4. Copy the generated key

Available Tools

Documentation & Help

Tool Description
n8n_tools_help Get usage guide and documentation
n8n_get_node_info Get information about common n8n nodes

Workflow Management

Tool Description
n8n_list_workflows List all workflows
n8n_get_workflow Get workflow details by ID
n8n_create_workflow Create a new workflow
n8n_update_workflow Update an existing workflow
n8n_delete_workflow Delete a workflow
n8n_activate_workflow Activate a workflow
n8n_deactivate_workflow Deactivate a workflow

Execution Management

Tool Description
n8n_list_executions List execution history
n8n_get_execution Get execution details
n8n_delete_execution Delete an execution record
n8n_trigger_webhook Trigger a workflow via webhook

System

Tool Description
n8n_health_check Check n8n API connectivity

Usage Examples

Check Connection

"Check the n8n connection"

List Workflows

"List all workflows in n8n"

Create a Workflow

"Create a webhook workflow that responds with the received data"

Get Node Information

"Show me how to configure a webhook node"

CLI Commands

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "cursor-n8n-mcp": { "command": "node", "args": ["/path/to/cursor-n8n-mcp/dist/index.js"], "env": { "MCP_MODE": "stdio", "LOG_LEVEL": "error", "N8N_API_URL": "https://your-n8n-instance.com", "N8N_API_KEY": "your-api-key" } } } }