N8n MCP SSE

一键部署n8n MCP服务器

模型上下文协议（MCP）服务器，允许AI代理通过自然语言与n8n工作流交互。

部署

一键部署到铁路


注： 单击按钮后，Railway将提示您配置必要的环境变量（见下文）。

Docker部署（手动/本地测试）

这 Dockerfile 在此存储库中配置为构建 n8n-mcp-server 并使用Supergateway运行它。

1. 构建Docker镜像：

   docker build -t n8n-mcp-server-supergateway .

1. 运行Docker容器：

   docker run --rm -it -p 8080:8080 \
     -e PORT=8080 \
     -e N8N_API_URL="YOUR_N8N_API_URL" \
     -e N8N_API_KEY="YOUR_N8N_API_KEY" \
     -e N8N_WEBHOOK_USERNAME="your_webhook_user" \
     -e N8N_WEBHOOK_PASSWORD="your_webhook_password" \
     -e DEBUG=true \
     n8n-mcp-server-supergateway

将占位符值替换为实际的n8n凭据。服务器将可通过SSE访问 http://localhost:8080。超级网关提供默认路径 /sse 对于事件流和 /message 用于发布消息。

配置

服务器需要以下环境变量。使用按钮部署到Railway时，系统将提示您输入这些内容。对于本地Docker运行，使用 -e 如上图所示。

• N8N_API_URL：您的n8n实例API URL（例如。， https://n8n.example.com/api/v1). 必修的。
• N8N_API_KEY：您的n8n API密钥。 必需 并被视为秘密。
• N8N_WEBHOOK_USERNAME：n8n webhook节点上基本身份验证的用户名（如果您的工作流使用受基本身份验证保护的webhook触发器）。违约： anyname.
• N8N_WEBHOOK_PASSWORD：n8n webhook节点上基本身份验证的密码。违约： somepassword.
• DEBUG：设置为 true 用于n8n mcp服务器和Supergateway的详细日志记录，或 false 用于生产。违约： false.
• PORT：应用程序将侦听的端口。Railway会自动设置此端口。超级网关使用此变量。这 Dockerfile 默认值为 8080.

生成n8n API密钥

1. 在浏览器中打开n8n实例。
2. 转到“设置”>“API”（或类似路径，具体取决于n8n版本）。
3. 创建具有适当权限的新API密钥。
4. 复制钥匙。

连接到服务器（客户端集成）

一旦 n8n-mcp-server 如果正在运行（例如，部署在Railway上或本地Docker中），它会通过服务器发送事件（SSE）公开MCP接口。

Docker容器中的Supergateway实例（定义见 Dockerfile)通常使MCP服务器在以下位置可用：

• SSE流： `http://:

/sse`

• 消息终结点： `http://:

/message`

（如果部署在铁路上， : 将是您的公共铁路URL，例如。， https://my-n8n-mcp.up.railway.app)

AI代理或MCP客户端有几种连接方式：

1. 直接SSE连接：

如果您的MCP客户端（例如，您的AI代理的框架）本机支持通过SSE URL和消息端点连接到MCP服务器，请使用上述URL对其进行配置。

示例 mcp.json 直接SSE的配置：

   {
     "n8n_local_docker_sse": {
       "url": "https://my-n8n-mcp.up.railway.app/sse",
       "disabled": false,
       "alwaysAllow": [
         "mcp_n8n_docker_direct_list_workflows", 
         "mcp_n8n_docker_direct_get_workflow",
         "mcp_n8n_docker_direct_create_workflow",
         "mcp_n8n_docker_direct_update_workflow",
         "mcp_n8n_docker_direct_delete_workflow",
         "mcp_n8n_docker_direct_activate_workflow",
         "mcp_n8n_docker_direct_deactivate_workflow",
         "mcp_n8n_docker_direct_list_executions"
       ],
       "timeout": 300
     }
   }

部署时，添加变量并确保公开railway中的8080端口。

1. 在客户端使用超级网关（SSE到stdio网桥）：

如果您的MCP客户端希望启动通过stdio（标准输入/输出）进行通信的本地命令，您可以使用 *另一个* 客户端计算机上本地的超级网关实例，用于将远程SSE连接桥接回stdio。

示例 mcp.json 或类似的客户端配置：

   {
     "mcpServers": {
       "n8n-remote-sse": {
         "command": "npx",
         "args": [
           "-y",
           "supergateway",
           "--sse", "http://:
", // Replace with your actual server URL
           "--outputTransport", "stdio",
           "--logLevel", "info" // Optional: for debugging Supergateway on the client
         ],
         "env": {
            // Any environment variables Supergateway client might need, usually none for this mode
         },
         "disabled": false
       }
     }
   }

在此客户端超级网关设置中：

- 您的AI代理的MCP客户端正在运行 npx -y supergateway --sse ... 作为他的命令。 - 此本地超级网关连接到您的远程 n8n-mcp-server的SSE端点。 - 然后，它通过stdio向您的AI代理提供MCP接口。

可用工具

服务器提供以下工具（通过上述建立的MCP连接访问）：

使用 Webhooks

此MCP服务器支持通过n8n webhooks执行工作流。要使用此功能，请执行以下操作：

1. 在n8n中创建由webhook触发的工作流。
2. 在webhook节点上设置基本身份验证（可选，但建议）。
3. 使用 run_webhook 工具来触发工作流，只传递工作流名称。

示例（概念性客户端代码）：

// Assuming 'mcp.tools.run_webhook' is available on your connected MCP client instance
const result = await mcp.tools.run_webhook({
  workflowName: "hello-world", // Will call /webhook/hello-world
  data: {
    prompt: "Hello from AI assistant!"
  }
});

Webhook身份验证（如果使用）使用 N8N_WEBHOOK_USERNAME 和 N8N_WEBHOOK_PASSWORD 为服务器配置的环境变量。

工作流管理

• workflow_list：列出所有工作流
• workflow_get：获取特定工作流的详细信息
• workflow_create：创建新工作流
• workflow_update：更新现有工作流
• workflow_delete：删除工作流
• workflow_activate：激活工作流
• workflow_deactivate：停用工作流

执行管理

• execution_run：通过API执行工作流

//注意：上面已经列出了run_webhook，通常是触发的首选。

• execution_get：获取特定执行的详细信息
• execution_list：列出工作流的执行情况

// execution_stop 可能无法在所有n8n版本或基础服务器中实现。

自助主机（高级）

对于喜欢在Docker或Railway等平台之外运行服务器的用户，可以直接运行Node.js应用程序。这为您提供了更多的控制，但需要手动设置执行环境，如果需要SSE，还可能需要超级网关。

1. 克隆存储库：

   git clone https://github.com/YOUR_USERNAME/YOUR_REPONAME.git # Replace with your repository URL
   cd YOUR_REPONAME

1. 安装依赖关系：

   npm install

1. 构建服务器：

   npm run build

这将TypeScript编译为JavaScript build 目录。

1. 配置环境变量：

创建一个 .env 项目根目录中的文件（您可以复制 .env.example)并填写n8n API的详细信息(N8N_API_URL, N8N_API_KEY等）和任何其他所需变量，如 PORT （如果不是8080）或 DEBUG.

1. 运行stdio MCP服务器：

   node build/index.js

这将启动 n8n-mcp-server 通过标准输入/输出（stdio）进行通信。

1. \*\*通过SSE进行曝光（可选，手动超级网关设置）：

如果你需要通过SSE访问这个自托管服务器，你需要运行自己的Supergateway实例来包装上面的stdio命令。例如：

   npx -y supergateway --stdio "node build/index.js" --port 8080 # Add other Supergateway flags as needed

确保步骤4中配置的环境变量可供访问 node build/index.js 当Supergateway启动时。

这种方法比Docker或Railway部署更复杂，后者在容器内自动处理Supergateway集成。

鸣谢

基于此回购：https://github.com/leonardsellem/n8n-mcp-server/

许可证

麻省理工学院