N8N MCP Server

N8N MCP 服务

这是一个用于与 N8N API 交互的模型控制协议（MCP）服务。它通过 MCP 端点提供简化的接口，以访问 N8N 功能。

这是什么？

此 MCP 服务充当 Claude 等 AI 助手与 N8N 自动化平台之间的桥梁。它使 AI 助手能够：

• 列出、创建、更新和删除工作流
• 执行工作流并管理工作流执行
• 管理凭据和标签
• 将 N8N 功能集成到对话流程中

要求

• Node.js 16+
• 可访问 API 的 N8N 实例
• N8N API 密钥

设置

1. 克隆此代码库：

   git clone https://github.com/bader1919/n8n-mcp-server.git
   cd n8n-mcp-server
   

2. 安装依赖项：

   npm install
   

3. 配置环境变量：

   • 将 .env.example 复制为 .env
   • 填写 N8N API 详情：
     • N8N_API_BASE_URL：N8N API 的 URL（默认值：http://localhost:5678/api/v1）
     • N8N_API_KEY：你的 N8N API 密钥
     • PORT：此 MCP 服务运行的端口（默认值：3000）

4. 启动服务：

   npm start
   

可用端点

工作流

• /mcp/listWorkflows：获取所有工作流
• /mcp/getWorkflow：按 ID 获取指定工作流
• /mcp/createWorkflow：创建新工作流
• /mcp/updateWorkflow：更新现有工作流
• /mcp/deleteWorkflow：删除工作流
• /mcp/activateWorkflow：激活工作流
• /mcp/deactivateWorkflow：停用工作流

执行

• /mcp/listExecutions：获取所有执行记录，可按工作流筛选
• /mcp/getExecution：按 ID 获取指定执行记录
• /mcp/deleteExecution：删除执行记录
• /mcp/executeWorkflow：使用可选数据执行工作流

凭据

• /mcp/listCredentials：获取所有凭据
• /mcp/getCredential：按 ID 获取指定凭据
• /mcp/createCredential：创建新凭据
• /mcp/updateCredential：更新现有凭据
• /mcp/deleteCredential：删除凭据

标签

• /mcp/listTags：获取所有标签
• /mcp/createTag：创建新标签
• /mcp/deleteTag：删除标签

与 Claude 配合使用

要将此 MCP 服务与 Claude 配合使用，请按以下步骤安装：

install_local_mcp_server path="./n8n-mcp-server"

然后，你就可以通过 MCP 端点访问 N8N 功能。Claude 可以通过自然语言对话帮助你构建和执行 N8N 工作流。

使用示例

下面是列出所有工作流的示例：

// Example call to listWorkflows
const result = await listWorkflows();
console.log(result);

执行工作流：

// Example call to executeWorkflow
const result = await executeWorkflow({
  workflowId: "1234",
  data: {
    input1: "value1",
    input2: "value2"
  }
});
console.log(result);

更多示例请参阅 example-client.js。

安全注意事项

• 此 MCP 服务需要 N8N API 凭据才能运行
• 将此服务暴露到公共互联网时请务必谨慎
• 如果要在生产环境中部署，请考虑使用 API 密钥或其他身份验证机制

许可证

MIT

贡献

欢迎提交拉取请求。对于重大变更，请先创建议题，讨论你希望进行的更改。