n8n管理MCP服务

n8n管理MCP服务是一个连接AI助手到n8n实例的工具,提供工作流、执行记录、凭证、标签、变量和用户管理的31种工具。

  • by node2flow-th
  • TypeScript
  • 混合部署
  • 更新于
在 GitHub 查看 node2flow-th/n8n-management-mcp-community

使用说明

n8n管理MCP服务器

泰语

MCP(模型上下文协议)服务器,用于将AI助手连接到n8n实例。通过31个工具管理工作流、执行、凭据、标签、变量和用户。

适用于Claude Desktop、Cursor、VS Code和任何MCP客户端。


快速开始

克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@node2flow/n8n-management-mcp"],
      "env": {
        "N8N_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-n8n-api-key"
      }
    }
  }
}

光标/VS代码

添加到MCP设置:

{
  "mcpServers": {
    "n8n": {
      "command": "npx",
      "args": ["-y", "@node2flow/n8n-management-mcp"],
      "env": {
        "N8N_URL": "https://your-n8n-instance.com",
        "N8N_API_KEY": "your-n8n-api-key"
      }
    }
  }
}

HTTP模式(流式HTTP)

对于远程部署或共享访问:

N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npx @node2flow/n8n-management-mcp --http

服务器在端口3000上启动(可通过配置 PORT env变量)。MCP端点: http://localhost:3000/mcp


配置

环境变量 必填 说明
N8N_URL 是 n8n实例的URL(例如。 https://n8n.example.com)
N8N_API_KEY 是 n8n API密钥(如何创建)
PORT 否 HTTP服务器的端口(默认值: 3000,仅用于 --http)

所有工具(31个工具)

工作流管理(10个工具)

工具 说明
n8n_list_workflows 列出所有带有状态和标签的工作流
n8n_get_workflow 获取工作流详细信息(节点、连接)
n8n_create_workflow 创建新工作流
n8n_update_workflow 更新工作流结构
n8n_delete_workflow 永久删除工作流
n8n_activate_workflow 激活工作流触发器
n8n_deactivate_workflow 停用工作流触发器
n8n_execute_workflow 使用输入数据执行工作流
n8n_get_workflow_tags 获取分配给工作流的标签
n8n_update_workflow_tags 更新工作流标签

执行历史(4个工具)

工具 说明
n8n_list_executions 列出执行历史记录(按工作流筛选)
n8n_get_execution 使用节点输出获取执行详细信息
n8n_delete_execution 删除执行记录
n8n_retry_execution 重试失败的执行

证书(4个工具)

工具 说明
n8n_create_credential 存储API凭据
n8n_update_credential 更新凭证数据
n8n_delete_credential 删除凭据
n8n_get_credential_schema 获取凭证类型的必填字段

标签(5工具)

工具 说明
n8n_list_tags 列出所有标签
n8n_get_tag 获取标签详细信息
n8n_create_tag 创建新标签
n8n_update_tag 重命名标签
n8n_delete_tag 删除标签

变量(4个工具)

工具 说明
n8n_list_variables 列出所有环境变量
n8n_create_variable 创建全局变量
n8n_update_variable 更新变量值
n8n_delete_variable 删除变量

用户管理(4个工具)

工具 说明
n8n_list_users 列出所有用户(仅限所有者)
n8n_get_user 获取用户详细信息
n8n_delete_user 删除用户
n8n_update_user_role 更改用户角色

需求

  • Node.js 18+
  • n8n实例 启用API时
  • n8n API密钥

如何创建n8n API密钥

  1. 转到n8n实例设置
  2. 选择API>API密钥
  3. 单击创建API键
  4. 复制密钥并将其用作 N8N_API_KEY

面向开发者

git clone https://github.com/node2flow-th/n8n-management-mcp-community.git
cd n8n-management-mcp-community
npm install
npm run build

# Run in stdio mode
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm start

# Run in dev mode (hot reload)
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm run dev

# Run in HTTP mode
N8N_URL=https://your-n8n.com N8N_API_KEY=your_key npm start -- --http

许可证

MIT许可证-请参阅 许可证

版权所有(c)2026 Node2Flow

链接