n8n MCP Community

n8n MCP Community

面向自托管 n8n Community Edition 的安全型 Model Context Protocol 服务

为你的 AI 客户端提供 44 个适用于自托管 n8n Community Edition 的工具。管理 工作流、节点、运行记录、凭据、标签、用户和诊断信息。不包含付费版 n8n 功能。该服务不会调用外部 AI。

安装

你需要 Node.js 22 或 24、n8n URL 和 n8n API 密钥。

安装

npm install --global n8n-mcp-community@latest

--global 会全局安装该命令一次。如果不想全局安装，请使用下方的 npx。

连接

{
  "mcpServers": {
    "n8n-community": {
      "command": "n8n-mcp-community",
      "env": {
        "N8N_API_URL": "https://n8n.example.com",
        "N8N_API_KEY": "replace-with-a-dedicated-api-key",
        "N8N_MCP_MODE": "read-only"
      }
    }
  }
}

重启客户端。你应该会看到 44 个工具、5 个资源和 4 个提示词。

如果客户端找不到该命令，请在 macOS/Linux 上运行 command -v n8n-mcp-community，或在 Windows 上运行 where n8n-mcp-community。将完整路径填入 "command"。

不想全局安装？将此命令复制到完整指南中所示的客户端配置里：

npx --yes n8n-mcp-community@latest

想使用 Claude Desktop 应用的安装流程？请使用下方的 MCPB。有关更新、回滚和检查，请参阅完整的 安装指南。

Claude Desktop：安装 MCPB（无需 Node.js）

1. 打开最新的 GitHub 版本发布页。
2. 下载以 .mcpb 结尾的文件。
3. 在 Claude Desktop 中，打开 Settings → Extensions → Advanced settings → Install Extension…。
4. 选择文件。输入 n8n URL、API 密钥和模式。

Anthropic 的 MCPB 指南 介绍了相同的步骤。我们的安装指南说明了如何检查下载文件。

仅从 npm 或 最新的 GitHub 版本发布页安装公开版本。

阅读演示文字记录。

为什么开发这个项目

• 优先支持 Community Edition。 发布范围专为自托管 n8n Community Edition 设计，不会将仅付费版提供的功能描述为可用功能。
• 44 个实用工具，一个明确的契约。 每个工具都有明确限制的输入、已记录的副作用、MCP 安全注释和契约测试。
• 默认安全。 默认采用只读模式。是否允许写入或启用完整工具集，由你决定。
• 确定性的 Introspect。 n8n_introspect 运行本地的 23 条规则引擎； 不会执行工作流、调用 Agent 或联系外部模型。
• 精准更新节点。 n8n_update_node 只更改一个经过验证的节点路径， 同时保留工作流的其余部分，并说明 Public API 的非原子性限制。
• 如实发现。 n8n_list_node_types 仅报告在可访问工作流中观察到的类型，不会声称提供完整的已安装目录。
• 数据最小化。 通用公共工具不会返回凭据值、原始执行值、固定数据和 静态工作流数据。

查看验证证据

## 当前验证情况

当前候选源码已通过以下验证：

• 通过真实 stdio 提供恰好 44 个工具、5 个资源和 4 个提示词；
• 在 Node.js 24.21.0 上本地测试 320 项全部通过；CI 和发布门禁要求使用固定的 Node.js 22.23.1 和 24.18.0 版本矩阵；
• Gitleaks、Semgrep、Trivy 和两次项目根目录生产级／完整 npm audit 均未发现问题；CI 会复现全部三项源码扫描，并使用不可变的扫描器／操作标识；
• 单独进行不带覆盖设置的使用方安装，确认解析到已修补的 @hono/node-server 2.x 系列，要求生产级审计零发现，并验证 stdio 运行时及确切的 44/5/4 清单；
• 可复现的依赖许可证门禁覆盖了 187 条已安装软件包路径；
• 有界同源 HTTP 契约测试，以及零请求策略拒绝测试；
• 在启用了出口隔离、密钥已撤销、清理完成且无残留的临时 n8n Community 2.30.5 和 2.30.7 实例上，验证了全部 44 个已编译工具的生命周期；以及
• 在项目已提交的依赖策略下，完成经审查的离线 npm 压缩包安装；另生成了可按字节复现、未签名的 MCPB，其中包含相同的已编译运行时和完整的生产依赖声明。

发布仅通过经审查的发布流程进行：使用仓库固定的 MCPB 签名身份、人工提供的制品基线收据、限定标签的受保护环境审批，以及逐字节对照经审查的未签名候选文件验证的外部签名 MCPB 交接。

安全模式

模式	允许的操作	所需配置
只读	仅只读工具	默认，或 N8N_MCP_MODE=read-only
写入	只读工具和常规变更工具	N8N_MCP_MODE=write
不安全	所有工具，包括破坏性操作或外部联络	N8N_MCP_MODE=unsafe

选择不安全模式即构成对不安全工具的完整服务端授权门禁。MCP 安全注解仍保持准确，以便兼容的客户端应用其原生审批 UX；n8n API 密钥仍是最终的上游权限边界。

仅对回环 URL 自动接受纯 HTTP。非回环 HTTP 实例还必须设置 N8N_ALLOW_INSECURE_HTTP=1，这表示接受 API 密钥和数据在传输过程中暴露的风险。

工具目录

每个条目都链接到完整的输入、输出、端点、兼容性、故障和安全参考。

工作流

工具	模式	用途
n8n_workflows_list	只读	使用有界筛选条件和分页列出可访问的工作流。
n8n_workflows_get	只读	读取一个工作流，但不返回固定数据和静态数据值。
n8n_workflows_create	写入	通过 Public API 创建经过验证的工作流。
n8n_workflows_update	写入	在保留未提供字段的同时，对选定字段进行保护并更新。
n8n_update_node	写入	在非原子并发保护下，更改一个经过验证的节点属性。
n8n_workflows_delete	不安全	永久删除一个工作流。
n8n_workflows_activate	不安全	激活一个工作流。
n8n_workflows_deactivate	不安全	停用一个工作流。
n8n_workflows_get_version	只读	获取一个保留的历史工作流版本。
n8n_workflows_get_tags	只读	列出分配给工作流的标签。
n8n_workflows_update_tags	写入	替换工作流的全部标签分配。
n8n_workflows_archive	不安全	归档一个工作流。
n8n_workflows_unarchive	不安全	恢复一个已归档的工作流。
n8n_workflows_diff	只读	比较节点和连接，但不返回原始值。

执行记录

工具	模式	用途
n8n_executions_list	只读	列出执行元数据，并提供不含值的数据存在情况摘要。
n8n_executions_get	只读	读取一条执行记录的元数据，但不返回工作流负载。
n8n_executions_delete	不安全	永久删除一条已保存的执行记录。
n8n_executions_retry	不安全	重试一条符合条件的已保存执行记录。
n8n_executions_stop	不安全	停止一条可停止的执行记录，并根据经过验证的输入绑定身份。

凭据

工具	模式	用途
n8n_credentials_create	写入	创建凭据，但不返回其值。
n8n_credentials_delete	不安全	永久删除一个凭据。
n8n_credentials_schema	只读	读取凭据类型的公开架构。
n8n_credentials_list	只读	列出已在 n8n 2.30.5 和 2.30.7 上验证的凭据元数据。
n8n_credentials_get	只读	读取一个凭据的公开元数据。
n8n_credentials_update	写入	更新凭据元数据或值，但不回显机密。
n8n_credentials_test	不安全	测试已存储的凭据，可能会联系其外部服务。
n8n_credentials_usage	只读	在一个有界的工作流页面中查找精确的凭据 ID 引用。

标签

工具	模式	用途
n8n_tags_list	只读	列出工作流标签。
n8n_tags_get	只读	读取一个标签。
n8n_tags_create	写入	创建一个符合实时 1–24 个字符限制的标签。
n8n_tags_update	写入	将标签重命名为符合实时 1–24 个字符限制的名称。
n8n_tags_delete	不安全	永久删除一个标签。

用户

工具	模式	用途
n8n_users_list	只读	列出 API 密钥可见的用户。
n8n_users_get	只读	通过稳定 ID 或精确邮箱地址读取一个用户。
n8n_users_create	不安全	邀请成员或管理员。
n8n_users_delete	不安全	删除一个符合 API 操作条件的用户，但不声称支持转移。

诊断和实例元数据

工具	模式	用途
n8n_health	只读	执行有界的同源健康检查。
n8n_insights_summary	只读	读取官方洞察摘要，可选日期筛选。
n8n_audit_generate	不安全	生成 n8n 实例安全审计。
n8n_search_workflows	只读	按名称、节点类型或标签在本地搜索一个工作流页面。
n8n_get_node_docs	只读	读取四份不可变的离线核心节点参考文档之一。
n8n_list_node_types	只读	汇总在有界的可访问工作流页面中观察到的节点类型。
n8n_introspect	只读	运行确定性的本地工作流和执行诊断。
n8n_community_packages_list	只读	列出已安装的社区包元数据，不包含变更操作路径。

资源和提示词

该服务还会公开五个静态资源：

• n8n://usage-guide
• n8n://node-docs/webhook
• n8n://node-docs/code
• n8n://node-docs/http-request
• n8n://node-docs/if

四个提示词用于指导安全地创建、调试和优化工作流，以及管理凭据：create-workflow、debug-workflow、 optimize-workflow 和 manage-credentials。

一分钟了解安全模型

• 该服务使用本地 stdio，不会公开入站 HTTP 监听器。
• 已连接的请求为同源请求，且仅限于配置的 n8n 主机。
• 重定向会被拒绝；请求和响应正文限制为 2 MiB。
• 通用输出经过验证、清理，限制为 256 KiB，并包装为 { "data": ..., "redacted": boolean, "untrusted": true }。
• 绝不会返回原始凭据值和通用执行载荷值。
• n8n_introspect 使用固定的本地规则，不包含外部模型代码路径。
• 安全控制可以降低风险，但无法确保不可信的 n8n 内容可安全执行，也不能授权更广泛的 API 密钥权限。

请阅读完整的安全模型，并使用 SECURITY.md 私下报告漏洞。

文档

• 文档索引
• 快速入门
• 安装和升级
• 配置
• 完整工具参考
• 经过测试的示例
• 常见问题
• 客户端配置
• 架构
• 安全模型
• 兼容性
• 故障排除
• 来源信息
• 路线图
• 更新日志

开发

npm ci
npm run verify:contributor
npm run sbom > sbom.cdx.json

npm run verify:contributor 会运行完整的无密钥贡献者检查流程，包括格式检查、依赖项许可证和声明、严格的 TypeScript 检查、所有测试、编译后的运行时，以及文档清单一致性检查。 提交更改前，请先阅读 CONTRIBUTING.md。

范围与非关联声明

本项目与 n8n GmbH 无关联，亦未获得其认可或赞助。 “n8n”仅用于说明本项目与 n8n 产品及 Public API 兼容。本项目不会重新分发 n8n-nodes-base 目录，也不会使用浏览器 Cookie、交互式会话路由或运行时软件包下载来构建该目录。

v0.3.x 的功能范围有意排除任意工作流执行、凭据/工作流传输、文件夹、数据表、Beta 评估端点以及执行注释。关于保留在发布目标之外的注释提案，请参阅路线图。

许可证与维护者

本项目根据 MIT 许可证 发布。第三方依赖仍受其各自许可证约束。

由 Dr. Walter Zamarian Jr.创建并维护。