n8n 工作流生成器 MCP 服务器

该项目提供了一个用于管理 n8n 工作流的 MCP 服务器。它通过一组定义的工具提供了列出、创建、更新、删除、激活和停用工作流的功能。

重要的：
此版本仅支持npm进行包管理和运行服务器。（npx 支持将在未来的更新中重新引入。）

要求

• Node.js（建议使用 v14+）
• npm

详尽的安装指南

1.克隆存储库

从您首选的来源克隆存储库。例如：

然后，导航到项目目录：

2.安装依赖项

使用 npm 安装必要的依赖项：

此命令将下载并安装package.json文件中定义的所有必需包。

3.构建和测试

要测试并使服务器上线，请使用以下命令：

• 构建项目：
  这将编译 TypeScript 文件并在build目录中生成可执行 JavaScript。
  npm run build
• 启动 MCP 服务器：
  使用以下方式启动服务器：
  npm start

服务器将启动并通过 stdio 连接。您可以检查控制台以查看确认服务器已正确启动的消息。

4.部署

出于测试目的并使服务器上线，请使用上面提到的构建和启动命令。此基本工作流程（安装、构建、启动）是目前推荐的方法。

5.附加配置

服务器配置通过cline_mcp_settings.json文件进行管理。请确保正确设置以下环境变量：

• N8N_HOST ：您的 n8n API 主机 URL。
• N8N_API_KEY ：您的 n8n API 密钥。

cline_mcp_settings.json中的示例配置：

可用功能

MCP 工具

服务器中定义了以下工具，可以通过您的 MCP 客户端访问：

工作流管理

• list_workflows ：列出来自 n8n 的所有工作流程。
• create_workflow ：在 n8n 中创建一个新的工作流程。
• get_workflow ：通过 ID 检索工作流。
• update_workflow ：更新现有的工作流程。
• delete_workflow ：通过 ID 删除工作流。
• activate_workflow ：通过 ID 激活工作流。
• deactivate_workflow ：通过 ID 停用工作流。

执行管理

• list_executions ：列出所有带有可选过滤器的工作流程执行。
• get_execution ：通过 ID 检索特定执行的详细信息。
• delete_execution ：通过 ID 删除执行。

MCP 资源

服务器还提供以下资源以实现更高效的上下文访问：

静态资源

• /workflows ：n8n 实例中所有可用工作流的列表
• /execution-stats ：有关工作流程执行的摘要统计信息

动态资源模板

• /workflows/{id} ：有关特定工作流的详细信息
• /executions/{id} ：有关特定执行的详细信息

故障排除

• 确保您正在使用 npm（此版本不支持 npx）。
• 如果遇到任何问题，请尝试清理构建目录并重建：
  npm run clean && npm run build
• 验证cline_mcp_settings.json中的环境变量是否正确。

未来的增强功能

• 重新引入 npx 支持。
• 附加工具和工作流程功能。
• 进一步增强部署和扩展。

执照

该项目已获得 MIT 许可。