← 返回目录
N

n8n-MCP

社区
让 AI 助手理解并构建 n8n 工作流。
GitHub 源仓库 ↗
★ 22.4k Stars 分类 · 开发工具 非常热门
58FMRS · C
可靠性
8/20
安全与权限
12/20
维护活跃度
13/20
文档质量
14/20
安装易用性
11/20

来源显示该服务器由 czlonkowski/n8n 维护,采用 MIT 许可证,服务器路径为仓库根目录。README 未缓存服务器清单,也未明确传输协议或完整安装配置。

查看 FMRS 评分方法 →

n8n-MCP 是一个 Model Context Protocol 服务器,为 AI 助手提供 n8n 节点文档、属性、操作、模板和工作流验证能力。它支持搜索和配置 n8n 的核心及社区节点,并可在配置 n8n API 后管理工作流、执行、凭据和数据表。

工具能力

tools_documentation
获取 MCP 工具文档。
search_nodes
搜索 n8n 节点及可选的配置示例。
get_node
获取节点信息、文档、属性、版本或迁移信息。
validate_node
验证节点配置。
validate_workflow
验证完整 n8n 工作流。
search_templates
搜索 n8n 工作流模板。
get_template
获取模板工作流内容。
n8n_create_workflow
创建 n8n 工作流。
n8n_get_workflow
获取 n8n 工作流。
n8n_update_full_workflow
完整替换 n8n 工作流。
n8n_update_partial_workflow
使用差异操作更新 n8n 工作流。
n8n_delete_workflow
永久删除 n8n 工作流。
n8n_list_workflows
列出并筛选 n8n 工作流。
n8n_validate_workflow
按工作流 ID 在 n8n 中验证工作流。
n8n_autofix_workflow
自动修复常见工作流错误。
n8n_workflow_versions
管理工作流版本历史并进行回滚。
n8n_deploy_template
将 n8n.io 模板部署到 n8n 实例。
n8n_test_workflow
测试或触发工作流执行。
n8n_executions
管理工作流执行记录。
n8n_evaluations
读取 n8n 评估测试运行及指标。
n8n_manage_datatable
管理 n8n 数据表和数据行。
n8n_manage_credentials
管理 n8n 凭据。
n8n_audit_instance
执行 n8n 实例安全审计。
n8n_health_check
检查 n8n API 连接和功能。

安装接入

可通过 dashboard.n8n-mcp.com 注册并获取 API key 后连接 MCP 客户端;也可按照仓库提供的自托管指南使用 npx、Docker、Railway 或本地方式部署。需要连接 n8n 实例时,配置 N8N_API_URL 和 N8N_API_KEY。若实例位于 Cloudflare Access 后方,还可配置 N8N_CF_CLIENT_ID 和 N8N_CF_CLIENT_SECRET。

选型与风险

适合谁

  • 使用 Claude、Cursor、Windsurf、VS Code、Codex 或 Antigravity 构建 n8n 自动化的开发者。
  • 需要节点文档、模板搜索和工作流验证能力的 n8n 用户。
  • 希望自托管或通过托管 dashboard 使用 n8n-MCP 的团队。

不适合谁

  • 不使用 n8n 的自动化场景。
  • 需要在没有配置 n8n API 的情况下执行 n8n 实例管理操作的用户。
  • 未经测试就直接修改生产工作流的场景。

所需权限

  • 基础节点、文档、模板和验证功能所需权限未在来源中明确说明。
  • n8n 管理功能需要 N8N_API_URL 和 N8N_API_KEY。
  • 凭据和数据表工具可能访问 n8n 中的敏感数据;来源建议在治理敏感环境中禁用这些工具。

风险与副作用

  • AI 生成结果可能不可预测;来源明确警告不要直接编辑生产工作流。
  • 应先复制工作流、在开发环境测试、备份重要工作流并在部署前验证。
  • 启用工作流写入、删除、凭据或数据表管理能力会扩大潜在影响范围。

常见排障

  1. 检查 N8N_API_URL 和 N8N_API_KEY 是否已正确配置。
  2. 使用 n8n_health_check 检查 API 连接和功能。
  3. 若 n8n 位于 Cloudflare Access 后方,检查 N8N_CF_CLIENT_ID 和 N8N_CF_CLIENT_SECRET。
  4. 参考仓库提供的自托管、HTTP 部署和 n8n 部署指南。

使用场景

搜索 n8n 节点、属性和官方文档。
基于模板或从头设计和验证 n8n 工作流。
在配置 n8n API 后创建、更新、测试和审计工作流。

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Windsurf完整支持
Cursor完整支持
Visual Studio Code完整支持
Codex完整支持
Antigravity完整支持