n8n MCP Server

什么是 n8n MCP Server？

这个 n8n MCP 服务器是社区开发的 Model Context Protocol 服务器（@leonardsellem/n8n-mcp-server），让 AI 助手可以通过 n8n REST API，用自然语言列出、创建、更新、激活和运行 n8n 工作流，并查看其执行记录。

它并非 n8n 官方出品。它使用 n8n API 密钥连接到你自己的 n8n 实例（云端或自托管），通过 stdio 在本地运行，可从 npm、源码或 Docker 镜像安装。n8n 本身现在也提供内置的 MCP 选项，下文对比部分会介绍。

如何使用 n8n MCP Server？

前提条件： Node.js 20 或更高版本，以及一个已启用 API 访问的 n8n 实例。

1. 创建 n8n API 密钥。 在 n8n 实例中进入 Settings > API > API Keys，创建一个具有相应权限的密钥并复制。

2. 安装服务器。

npm install -g @leonardsellem/n8n-mcp-server

或使用 Docker 运行：

docker run -e N8N_API_URL=http://your-n8n:5678/api/v1 \
  -e N8N_API_KEY=your_n8n_api_key \
  -e N8N_WEBHOOK_USERNAME=username \
  -e N8N_WEBHOOK_PASSWORD=password \
  leonardsellem/n8n-mcp-server

3. 设置环境变量。

变量	用途
N8N_API_URL	包含 /api/v1 的完整 n8n API URL，例如 http://localhost:5678/api/v1
N8N_API_KEY	你的 n8n API 密钥
N8N_WEBHOOK_USERNAME / N8N_WEBHOOK_PASSWORD	Basic Auth 凭据，仅在使用 webhook 工具时需要
DEBUG	可选的调试日志

Claude Desktop 和 VS Code

README 中的示例配置使用 node 运行构建后的文件。执行 npm run build 后，填写 build/index.js 的绝对路径：

{
  "mcpServers": {
    "n8n-local": {
      "command": "node",
      "args": ["/path/to/your/cloned/n8n-mcp-server/build/index.js"],
      "env": {
        "N8N_API_URL": "http://your-n8n-instance:5678/api/v1",
        "N8N_API_KEY": "YOUR_N8N_API_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

如果是通过 npm 全局安装的，README 说明可以直接用 n8n-mcp-server 作为命令，而不必填写 node 路径。

Claude Code

全局 npm 安装后：

claude mcp add n8n -e N8N_API_URL=http://localhost:5678/api/v1 -e N8N_API_KEY=YOUR_N8N_API_KEY -- n8n-mcp-server

Cursor

在 ~/.cursor/mcp.json 中使用同样的 mcpServers 配置块，命令填写 n8n-mcp-server 或 node 路径。

n8n MCP Server 的主要功能

• 完整的工作流管理：列出、获取、创建、更新、删除、激活和停用
• 通过 n8n API 或 webhook 运行工作流
• 查看、列出和停止执行记录
• 为工作流和执行记录提供 MCP 资源，例如 n8n://workflows/list
• 使用环境变量中的 Basic Auth 自动为 webhook 调用认证
• 通过公开 REST API 支持 n8n 云端或自托管实例
• 提供 npm 包、源码和 Docker Hub 镜像；采用 MIT 许可证

n8n MCP Server 工具

工具分为两组：

• 工作流管理： workflow_list、workflow_get、workflow_create、workflow_update、workflow_delete、workflow_activate 和 workflow_deactivate。
• 执行管理： execution_run 通过 API 运行工作流，run_webhook 按名称触发 webhook 工作流（调用 <n8n-url>/webhook/<workflowName>），execution_get、execution_list 和 execution_stop 用于查看或停止运行。

资源以只读方式提供同样的数据：n8n://workflows/list、n8n://workflow/{id}、n8n://executions/{workflowId} 和 n8n://execution/{id}。

n8n MCP Server 的使用场景

• 工作流盘点：“List all my n8n workflows and tell me which ones are inactive.”
• 在对话中搭建：“Create a workflow that posts new form submissions to Slack, but leave it inactive.”
• 触发自动化：“Run the hello-world webhook workflow with the prompt 'Hello from AI assistant!'”
• 排查问题：“Show the last five failed executions of the invoice-sync workflow and what went wrong.”
• 运维操作：“Stop the execution that has been running for over an hour, then deactivate that workflow.”

n8n MCP Server 与替代方案对比

n8n 现在自带 MCP 功能。MCP Server Trigger 节点可以把单个 n8n 工作流变成一个 MCP 服务器，其工具就是 n8n 的工具节点，支持 SSE 或 Streamable HTTP。实例级 MCP 访问允许所有者或管理员在 n8n 设置中把选定的工作流开放给 MCP 客户端。如果你希望智能体通过 REST API、以本地 stdio 服务器的方式直接管理工作流本身（创建、编辑、激活、删除），就选择这个社区版 n8n MCP 服务器。另外也有其他工具集各不相同的社区 n8n MCP 项目。

n8n MCP Server 常见问题排查

• 认证错误或 404： 检查 N8N_API_URL 是否包含 /api/v1，以及 API 密钥是否有效并具备所需权限。
• 客户端无法启动服务器： 先运行 npm run build，并使用 build/index.js 的绝对路径和正确的路径分隔符（Windows 上用双反斜杠）。
• webhook 调用失败： run_webhook 使用 Basic Auth。设置 N8N_WEBHOOK_USERNAME 和 N8N_WEBHOOK_PASSWORD，并在 webhook 节点上启用 Basic Authentication。
• 运行的是旧版本： 用 npm install -g @leonardsellem/n8n-mcp-server@latest 或 docker pull leonardsellem/n8n-mcp-server:latest 更新，然后重启服务器。
• 需要更多细节： 设置 DEBUG=true 启用调试日志。