N8n MCP Server V2

n8n MCP服务器

用于n8n工作流自动化的综合MCP（模型上下文协议）服务器。此连接器为Claude Desktop提供 全部 提供n8n API操作，可直接从Claude进行完整的工作流程管理。

特性

与有限的默认连接器不同，此服务器包括 40+工具 涵盖：

工作流管理

• n8n_list_workflows -列出所有具有过滤功能的工作流
• n8n_get_workflow -获取完整的工作流详细信息，包括节点和连接
• n8n_create_workflow -使用节点和连接创建新的工作流
• n8n_update_workflow -更新现有工作流
• n8n_delete_workflow -删除工作流
• n8n_activate_workflow -激活工作流
• n8n_deactivate_workflow -停用工作流
• n8n_run_workflow -手动执行工作流
• n8n_update_workflow_tags -更新工作流标签关联
• n8n_duplicate_workflow -创建工作流的副本
• n8n_export_workflow -将工作流导出为JSON
• n8n_import_workflow -从JSON导入工作流
• n8n_transfer_workflow -将工作流转移到另一个项目

执行管理

• n8n_list_executions -列出带有过滤功能的工作流执行情况
• n8n_get_execution -获取详细的执行信息
• n8n_delete_execution -删除单个执行
• n8n_delete_executions -批量删除执行
• n8n_stop_execution -停止正在运行的执行
• n8n_retry_execution -重试失败的执行

凭证管理

• n8n_list_credentials -列出所有凭据
• n8n_get_credential -获取凭证详细信息
• n8n_create_credential -创建新凭据
• n8n_update_credential -更新现有凭据
• n8n_delete_credential -删除凭据
• n8n_get_credential_schema -获取凭证类型的必填字段
• n8n_transfer_credential -将凭据转移到另一个项目

标签管理

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

变量管理

• n8n_list_variables -列出所有环境变量
• n8n_get_variable -获取变量详细信息
• n8n_create_variable -创建新变量
• n8n_update_variable -更新变量
• n8n_delete_variable -删除变量

项目管理

• n8n_list_projects -列出所有项目
• n8n_get_project -获取项目详细信息
• n8n_create_project -创建新项目
• n8n_update_project -重命名项目
• n8n_delete_project -删除项目

用户管理

• n8n_list_users -列出所有用户
• n8n_get_user -获取用户详细信息
• n8n_get_current_user -获取当前经过身份验证的用户

源代码管理（Git）

• n8n_source_control_status -获取Git状态
• n8n_source_control_pull -从远程拉取更改
• n8n_source_control_push -将更改推送到远程
• n8n_source_control_disconnect -断开Git集成

安全和公用事业

• n8n_check_connection -测试API连接
• n8n_generate_audit -生成安全审计报告
• n8n_get_node_types -列出可用节点类型
• n8n_get_active_webhooks -列出活动的Webhook

安装

先决条件

• Node.js 18或更高版本
• 已启用API访问的n8n实例
• n8n API密钥（在n8n设置中生成→ API)

设置

1. 克隆或下载此项目:

   git clone git@github.com:DrBalls/n8n-mcp-server-v2.git
   cd n8n-mcp-server-v2

1. 安装依赖项:

   npm install

1. 构建项目:

   npm run build

1. 配置Claude桌面:

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

   {
     "mcpServers": {
       "n8n": {
         "command": "node",
         "args": ["/absolute/path/to/n8n-mcp-server-v2/dist/index.js"],
         "env": {
           "N8N_URL": "http://localhost:5678",
           "N8N_API_KEY": "your-api-key-here"
         }
       }
     }
   }

1. 重新启动克劳德桌面

配置

环境变量

获取API密钥

1. 打开n8n实例
2. 首选 设置 → API
3. 点击 创建API密钥
4. 复制生成的密钥

使用示例

创建简单工作流

Create a new n8n workflow called "Hello World" with:
1. A manual trigger node
2. A Set node that outputs {"message": "Hello, World!"}

列出和筛选工作流

Show me all active workflows tagged with "production"

使用输入运行工作流

Execute workflow ID abc123 with input data: {"email": "test@example.com"}

管理凭据

List all Slack credentials and show me the schema for creating new ones

检查执行状态

Show me the last 10 failed executions and their error messages

源代码管理

What's the current Git status? Are there any unpushed changes?

常见节点类型

创建工作流时，请使用以下节点类型标识符：

故障排除

连接失败

• 验证您的 N8N_URL 正确且可访问
• 检查您的API密钥是否有效
• 确保在设置中启用n8n API访问

权限不足

• 您的API密钥可能没有足够的权限
• 检查API用户是否有权访问请求的资源

未找到工作流

• 验证工作流ID是否正确
• 检查指定项目中是否存在工作流

发展

建筑

npm run build

测试连接

构建后，测试连接：

N8N_URL=http://localhost:5678 N8N_API_KEY=your-key node dist/index.js

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交问题或拉取请求。