适合谁
- 使用 n8n 进行自动化并希望利用 AI 助手简化工作流管理的团队。
- 希望在不直接使用 n8n Web UI 的情况下，通过对话界面创建工作流的用户。
- 需要将 AI 助手集成到现有 n8n 工作流中的开发者。
N
44FMRS · D
根据提供的 README，该服务器是社区项目，非官方维护。它提供了全面的工具集，但安全性依赖于用户正确配置 API 密钥和网络访问。建议在生产环境中谨慎使用，并定期审查权限。
这个 MCP 服务器将 AI 助手（如 Claude Desktop、ChatGPT、Cline 等）直接连接到你的 n8n 实例，让你可以通过自然语言指令来创建、管理、执行和监控 n8n 工作流。它提供了一套全面的工具，涵盖了工作流的完整生命周期，包括创建、读取、更新、删除、激活/停用、执行、查看执行记录、管理标签以及生成安全审计报告。该服务器使用 n8n 的官方 API，并需要有效的 API 密钥进行认证。
工具能力
list_workflows
列出 n8n 实例中的所有工作流。
get_workflow
获取特定工作流的详细信息。
create_workflow
创建包含节点和连接的新工作流。
execute_workflow
手动执行一个工作流。
update_workflow
更新现有工作流的配置。
activate_workflow
激活工作流以启用自动执行。
deactivate_workflow
停用工作流以停止自动执行。
delete_workflow
永久删除一个工作流。
create_workflow_and_activate
创建新工作流并立即激活。
list_executions
列出工作流执行记录，支持过滤和分页。
get_execution
获取特定执行记录的详细信息。
delete_execution
删除工作流执行记录。
list_tags
列出所有工作流标签。
create_tag
创建新的工作流标签。
generate_audit
生成综合安全审计报告。
安装接入
- 通过 Smithery.ai 使用托管版本（无需安装）或使用 NPX 本地运行：
npx @makafeli/n8n-workflow-builder。 - 配置环境变量：
N8N_HOST（你的 n8n 实例 URL）和N8N_API_KEY（你的 n8n API 密钥）。 - 在你的 AI 助手的 MCP 配置中添加服务器。例如，对于 Claude Desktop，编辑
claude_desktop_config.json并添加上述配置。
claude_desktop_config.json
{
"mcpServers": {
"n8n-workflow-builder": {
"command": "npx",
"args": [
"@makafeli/n8n-workflow-builder"
],
"env": {
"N8N_HOST": "http://localhost:5678",
"N8N_API_KEY": "your-api-key-here"
}
}
}
}
选型与风险
不适合谁
- 没有 n8n 实例或 API 密钥的用户。
- 寻求完整低代码可视化界面而非 AI 驱动管理的用户。
- 需要与 n8n 官方产品团队直接支持或维护的用户。
所需权限
- 需要访问 n8n 实例的 URL（`N8N_HOST`）和 API 密钥（`N8N_API_KEY`）。
- API 密钥应具有相应的权限，通常需要读写工作流、执行、标签和审计的权限。
- 服务器直接与你的 n8n 实例通信，不存储数据，但需要网络访问权限。
风险与副作用
- API 密钥泄露可能导致未授权访问你的 n8n 工作流和数据。
- 错误配置可能导致工作流被意外修改、删除或执行。
- 涉及自动化操作时，应先在小范围测试。
- 依赖第三方托管服务（如 Smithery.ai）时，需注意数据隐私。
常见排障
- 连接拒绝（ECONNREFUSED）：检查 `N8N_HOST` 是否正确且 n8n 正在运行。
- 401 错误：验证 `N8N_API_KEY` 是否正确且未过期，并确保具有适当权限。
- 404 错误：使用 `list_workflows` 获取有效的工作流 ID。
- 服务器无法启动：确保 Node.js v18+ 已安装，并尝试 `npm cache clean --force`。
- 启用调试模式：`DEBUG=n8n-workflow-builder npx @makafeli/n8n-workflow-builder`。
使用场景
通过自然语言指令列出、浏览和管理 n8n 工作流。
自动创建复杂的工作流，根据描述生成节点和连接。
按需执行工作流，并监控执行状态。
批量更新或停用多个工作流。
管理工作流标签，进行组织和分类。
生成安全审计报告，用于合规性检查。
支持客户端
Claude Desktop完整支持
Cline完整支持
Continue完整支持
Other MCP-compatible clients完整支持