关于 n8n Manager MCP
n8n Manager MCP 连接 AI 助手与 n8n 实例,用于管理工作流。它结合多实例路由、变更前快照和离线节点目录,并设有安全检查。
主要功能
- 01创建、查看和管理 n8n 工作流
- 02在多个 n8n 实例间路由请求
- 03工作流变更前创建快照
- 04通过离线目录查看节点结构
- 05导出和导入工作流
适用场景
- 01通过 AI 助手创建或检查 n8n 工作流
- 02在开发和生产实例间迁移工作流
- 03无需 API 调用即可查看节点结构
- 04从本地快照恢复工作流
MCP 相关
本地 stdio MCP 服务提供工作流操作、执行记录、备份和节点相关工具。它将请求路由到已配置的 n8n 实例,并对变更操作执行安全检查。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
18收录的工具列表 · 更新于 3 天前
此工具无需参数。
详细介绍
n8n Manager MCP 服务
🇩🇪 德语版
属于 ellmos-ai 家族及 open-bricks 旗下项目。
说明
面向 AI 助手和大模型: 根目录中提供了
llms.txt索引文件,便于快速载入上下文、查阅工具目录及查看目录列表。
用于通过 Claude、Cursor 和 Windsurf 等 AI 助手管理 n8n 工作流的 MCP(模型上下文协议)服务。
快速导航
| 编号 | 章节 | 重点 |
|---|---|---|
| 01 | 📐 系统架构与拓扑 (#system-architecture) | 本地 stdio 传输、多服务路由和安全中间件 |
| 02 | 📊 双 Mermaid 图表 (#dual-mermaid-diagrams) | 组件架构 flowchart TD 与安全变更生命周期时序图 |
| 03 | 🌐 目录状态与注册平台 (#directory-status) | 在 npm、Glama、PulseMCP 和 Enterprise DNA 上的官方条目 |
| 04 | 🎯 目标用户画像与可发现性 (#target-personas--discoverability) | 将用户画像 [PERSONA-01] 映射至 [PERSONA-04],以及高意向 SEO 搜索词 |
| 05 | ⚖️ 对比矩阵与替代方案 (#comparative-matrix--alternatives) | 从 10 个维度对比原始 REST API、shell CLI、浏览器 UI 和云 SaaS |
| 06 | 🛡️ 核心能力与安全不变量 (#core-capabilities--safety-invariants) | 10 项形式化不变量(INV-LOCAL-01 至 INV-SLA-10)、只读门控和审计日志 |
| 07 | ✨ 主要功能 (#features) | 直接集成 REST、多服务路由、备份快照、节点目录 |
| 08 | ⚙️ 客户端安装 (#installation) | 为 Claude Code、Claude Desktop、Cursor 和 Windsurf 提供一键安装 |
| 09 | 🚀 快速开始 (#quick-start) | 逐步创建工作流、检查执行情况并切换服务 |
| 10 | 🛠️ 可用工具(19 项) (#available-tools) | 涵盖 CRUD、执行、备份和节点的完整 MCP 工具参考 |
| 11 | 🔗 可选:n8n-workflow-manager 接口 (#optional-n8n-workflow-manager-seam) | 与配套管理服务集成决策跟踪和变更历史 |
| 12 | 🔒 配置与安全默认值 (#configuration) | 环境变量、本地备份根目录和严格的单调约束 |
| 13 | 🧪 开发与测试 (#development) | 多操作系统 Vitest 测试套件、冒烟测试运行器和离线节点目录测试 |
| 14 | 🧱 ellmos-ai 生态系统 (#ellmos-ai-ecosystem) | 配套 MCP 服务、BACH Agent OS 和 open-bricks 桌面软件套件 |
| 15 | 📜 第三方许可证与透明度 (#third-party-licenses--transparency) | 100% 采用宽松开源许可证的依赖(MIT、BSD、Apache-2.0) |
| 16 | 📈 营销与用户画像日志 (#marketing--personas-log) | 全面的定位日志、关键词矩阵和三阶段路线图 |
| 17 | 📝 更新日志 (#changelog) | 完整的发行说明、安全加固记录和可发现性历史 |
| 18 | ⚖️ 责任 / Haftung (#haftung--liability) | 根据 §§ 516 ff. BGB 发布的法定开源捐赠声明、MIT 免责声明、48h SLA |
系统架构
n8n Manager MCP Server 是一个本地优先、通过 stdio 连接的桥接服务,连接 AI 开发环境(Claude Code、Claude Desktop、Cursor、Windsurf)与本地或远程 n8n 实例。
- 进程模型: 作为专用 Node.js 子进程完全在用户空间(
RunAsInvoker)中运行,并通过标准输入/输出(stdio)使用 JSON-RPC 2.0 进行通信。 - 失败时默认拒绝的安全中间件: 每次变更工具调用在联系 n8n API 或访问文件系统之前,都会经过不可变的安全关卡。
- 多实例路由器: 可无缝面向彼此独立的 n8n 实例(开发、预发布、生产),并隔离 API 凭据、以原子方式持久化配置。
- 离线节点目录: 无需 API 延迟或网络调用,即可即时检查节点架构(
n8n_describe_nodes)。
架构拓扑投影(4 视图模型)
+========================================================================================================+
| [VIEW 1: CALLER RUNTIMES & AGENT ECOSYSTEM] |
| Claude Code CLI | Claude Desktop | Cursor IDE / Windsurf | Antigravity / Gemini / Codex |
| (JSON-RPC 2.0 Stdio) | (stdio MCP Client) | (Dev Environments) | (Autonomous Orchestrator Swarms) |
+===================================================+====================================================+
|
v
+========================================================================================================+
| [VIEW 2: N8N-MANAGER-MCP CORE ENGINE & SAFETY ARBITRATION] |
| +----------------------------------------------------------------------------------------------------+ |
| | Tool Dispatcher (19 Registered MCP Tools: CRUD, Execution Inspect, Backup/Restore, Node Catalog) | |
| +----------------------------------------------------------------------------------------------------+ |
| | Fail-Closed Safety Filter: N8N_MANAGER_READ_ONLY Enforcement (INV-READ-02) | |
| | Input Validation & Sanitization: Zod Schema Numeric Bounds & Path Traversal Guards (INV-TRAV-06) | |
| | Multi-Instance Routing Engine: Development / Staging / Production Credentials Isolation (INV-SRV-05)| |
| | Bundled Offline Node Catalog: In-Memory Node Schemas & Parameter Introspection (INV-NODE-09) | |
| +----------------------------------------------------------------------------------------------------+ |
+===================================================+====================================================+
|
v
+========================================================================================================+
| [VIEW 3: RUNTIME PERSISTENCE, BACKUP SNAPSHOTS & LOCAL AUDIT WAL] |
| +------------------------------------+----------------------------------+----------------------------+ |
| | Pre-Mutation Workflow Snapshots | Append-Only Local Audit Trail | Multi-Server Config Store | |
| | ~/.n8n-manager-mcp/backups/ | ~/.n8n-manager-mcp/audit.log | ~/.n8n-manager-mcp/ | |
| | ({server}/{id}-{timestamp}.json) | (Forensic Timestamped Log) | (servers.json, 0600 mode) | |
| +------------------------------------+----------------------------------+----------------------------+ |
+===================================================+====================================================+
|
v
+========================================================================================================+
| [VIEW 4: DEFENSE PERIMETER, ZERO-EGRESS & RUNASINVOKER] |
| Standard User Mode (RunAsInvoker: Non-Elevation INV-PRIV-07) | Zero Outbound Telemetry / Ad Tracking |
| Local Loopback Binding (127.0.0.1 Default INV-LOCAL-01) | SLA & Vulnerability Protocol (INV-SLA-10) |
+========================================================================================================+
双 Mermaid 图
组件架构
flowchart TD
Client["AI Client (Claude Code / Desktop / Cursor / Windsurf)"] -->|"MCP Stdio Protocol (JSON-RPC 2.0)"| Router["Tool Router (19 Tools)"]
subgraph MCPServer["n8n Manager MCP Server (Local Stdio Process)"]
Router --> Safety["Safety Layer (Read-Only Gate & Traversal Guard)"]
Safety --> Backup["Pre-Mutation Snapshot Engine"]
Safety --> MultiServer["Multi-Server Manager"]
Safety --> Catalog["Offline Node Catalog (n8n_describe_nodes)"]
Backup --> Audit["Append-Only Audit Logger"]
end
MultiServer -->|"REST API (API Key / Auth Header)"| LocalInst["Local n8n Instance (127.0.0.1:5678)"]
MultiServer -->|"REST API (HTTPS / Token)"| CloudInst["Remote / Cloud n8n Instance"]
Backup --> BackupFS[("Backups (~/.n8n-manager-mcp/backups/)")]
Audit --> AuditFS[("Audit Log (~/.n8n-manager-mcp/audit.log)")]
安全工作流变更生命周期
sequenceDiagram
autonumber
actor AI as AI Assistant (Claude / Cursor)
participant MCP as n8n-manager-mcp Router
participant Safety as Safety & Read-Only Gate
participant Snapshot as Backup Engine
participant Store as Local Storage (~/.n8n-manager-mcp)
participant N8N as n8n REST API Instance
participant Audit as Forensic Audit Logger
AI->>MCP: Call Mutation Tool (n8n_update_workflow / n8n_delete_workflow)
MCP->>Safety: Check N8N_MANAGER_READ_ONLY
alt Read-Only Active (INV-READ-02)
Safety-->>AI: Blocked: Read-only mode active (Fail-Closed)
Safety->>Audit: Record blocked mutation attempt
else Mutation Permitted
Safety->>Snapshot: Trigger Pre-Mutation Snapshot (INV-BACK-03)
Snapshot->>N8N: GET /workflows/{id} (Fetch current state)
N8N-->>Snapshot: Current Workflow JSON
Snapshot->>Store: Save timestamped backup (~/backups/{server}/{id}-{timestamp}.json)
Snapshot-->>Safety: Backup verified & path resolved
Safety->>N8N: Execute Mutation (PUT / DELETE / PATCH)
N8N-->>Safety: Mutation Response (200 OK / Updated ID)
Safety->>Audit: Append structured forensic receipt (INV-AUDIT-04)
Safety-->>AI: Success response with backup path & rollback receipt
end
目录状态
- npm 软件包:已以
n8n-manager-mcp发布 - Glama 条目:ellmos-ai 仓库的公开目录页面
- Enterprise DNA 目录:
ellmos-ai/n8n-manager-mcp的另一条公开目录记录 - PulseMCP 条目:索引名为
ellmos-ai-n8n-manager - MCP 命名空间状态:此仓库包含
server.json和mcpName元数据,命名空间为io.github.ellmos-ai/n8n-manager-mcp;部分生态目录在索引刷新前仍显示旧名称io.github.lukisch/n8n-manager-mcp。 - 搜索关键词:使用
n8n MCP server、n8n workflow management MCP、AI assistant n8n workflows和ellmos-ai n8n-manager-mcp最容易找到。
目标用户画像与可发现性
| 用户画像 | 核心需求 | 解决的痛点 | 目标搜索词 |
|---|---|---|---|
| [PERSONA-01] 自主 AI Agent 与集群 | 非破坏性工作流操作、变更前快照、确定性回执 | 大模型幻觉破坏正在运行的生产工作流;无法离线检查节点连接 | n8n mcp server、ai agent n8n workflow management、claude code n8n automation |
| [PERSONA-02] DevOps 与多环境工程师 | 安全的多服务路由、跨阶段导出/导入同步 | 手动导出 JSON 的繁琐操作;预发布与生产环境之间的配置漂移;未经版本管理的工作流副本 | n8n multi-server mcp、sync n8n workflows staging prod、n8n workflow export import mcp |
| [PERSONA-03] SecOps、合规与风险团队 | 单向只读锁、本地审计追踪、杜绝外部数据泄露 | Agent 未受监管的变更;未经审查的 API 调用;变更取证历史丢失 | safe n8n mcp server、read-only n8n automation、audit log n8n ai integration |
| [PERSONA-04] 生态构建者与工具集成者 | 标准化 MCP 架构、经过验证的清单、可靠的 TypeScript SDK 接口 | 不同 MCP 目录之间的架构不匹配;缺少回归测试和契约测试套件 | modelcontextprotocol n8n、glama n8n-manager-mcp、smithery n8n workflow |
高意向搜索查询
n8n mcp server claude codeai assistant n8n workflow managementlocal-first n8n mcp stdiosafe n8n automated workflow mutationn8n multi-server workflow sync mcpn8n describe nodes offline catalogzero-egress n8n agent automationmodelcontextprotocol n8n typescript
对比矩阵与替代方案
| 维度 | n8n-manager-mcp | 直接调用 n8n REST API | 标准 Agent Shell | 手动使用 n8n Web UI | 通用云 SaaS |
|---|---|---|---|---|---|
| 主要接口 | 原生 MCP Stdio(JSON-RPC) | 原始 HTTP REST(Curl/Axios) | 临时 CLI / Bash 脚本 | 交互式 Web 画布 | 专有 Web 门户 |
| 安全防护措施 | 单调只读门控(N8N_MANAGER_READ_ONLY=1) | 无(未经检查的 API 执行) | Shell 退出代码启发式判断 | 人工确认弹窗 | 远程供应商 RBAC |
| 变更备份 | 自动创建变更前 JSON 快照(INV-BACK-03) | 无(覆盖运行中的实例) | 无(取决于脚本) | 无(直接修改画布) | 取决于供应商的快照 |
| 回滚功能 | 从本地磁盘一键执行 n8n_restore_workflow | 通过 POST 手动重建 JSON | 手动编写脚本回滚逻辑 | 在画布上手动重建节点 | 供应商提供的回滚界面(需付费) |
| 取证审计日志 | 仅追加的结构化 audit.log(INV-AUDIT-04) | 通用 Web 服务器访问日志 | 临时终端标准输出 | 仅画布执行日志 | 云供应商日志保留 |
| 节点内省 | 内置离线目录(n8n_describe_nodes) | 手动查阅在线文档 | 猜测并试验参数 | 通过可视化面板浏览 | 在线 API 文档 |
| 多服务隔离 | 隔离存储的配置文件(servers.json) | 在脚本中手动切换令牌 | Shell 历史记录暴露令牌 | 多标签页凭据混乱 | 切换云工作区 |
| 隐私与零外发 | 100% 本地 Stdio 传输,零遥测 | 直接通过 HTTP 客户端传输流量 | 本地 Shell 执行 | 浏览器遥测与分析 | 由远程第三方托管 |
| 工作流迁移 | 内置 n8n_export_workflow 与 n8n_import_workflow | 自定义 Python/Curl ETL 脚本 | 复杂的 bash/jq 管道 | 下载 / 上传 JSON 对话框 | 云企业版付费功能 |
| 许可证与安全审计 | 100% 宽松的 MIT 许可证(经过审计,安全问题 48 小时响应 SLA) | Fair-Code(n8n 源代码可用) | 许可证混杂 / 临时采用 | 商业版 / Fair-Code | 闭源专有 SaaS |
核心能力与安全不变量
| 不变量 ID | 能力 / 不变量 | 技术保障 | 用户收益 |
|---|---|---|---|
INV-LOCAL-01 | 100% 本地优先,零数据外流 | 使用 MCP Stdio 传输;默认仅绑定到 127.0.0.1;不收集外部遥测数据 | 完全保护隐私;工作流逻辑或凭据绝不会离开你的主机 |
INV-READ-02 | 单调只读强制机制 | N8N_MANAGER_READ_ONLY=1 建立进程级上限,不受工具覆盖影响 | 可验证地实现气隙隔离,防止意外删除或修改工作流 |
INV-BACK-03 | 变更前自动备份 | 在修改 / 删除前,将完整工作流 JSON 快照存储在 ~/.n8n-manager-mcp/backups/ 下 | 如有意外修改,可通过 n8n_restore_workflow 即刻一键回滚 |
INV-AUDIT-04 | 本地审计跟踪 | 在 ~/.n8n-manager-mcp/audit.log 中追加结构化 JSON 日志 | 完整追踪所有 Agent 操作和执行结果,便于取证 |
INV-SRV-05 | 多服务与凭据隔离 | 在 servers.json 中加密 / 隔离服务配置;验证 API 密钥中的空白字符 | 在预发布和生产环境之间无缝迁移工作流 |
INV-TRAV-06 | 严格的输入与路径遍历防护 | 限制数值范围(1..1000)和连接索引(0..1000);拒绝路径逃逸 | 防止目录遍历、原型污染及格式错误的负载导致崩溃 |
INV-PRIV-07 | 不提升权限与用户空间安全 | 严格以非特权用户进程运行 | 本地或 CI 执行均无需 root / 管理员权限 |
INV-SEAM-08 | 可选启用的决策历史衔接 | 通过 N8N_MCP_MANAGER_URL 对接 n8n-workflow-manager;显式快速失败 | 衔接人工决策日志与版本管理,同时不影响标准 MCP 模式 |
INV-NODE-09 | 内置节点目录与内省 | 提供全面的离线目录,涵盖触发器、操作、逻辑、转换和 AI 节点 | 大模型无需反复尝试网络调用,即可生成有效的节点连接 |
INV-SLA-10 | 多 Node.js 版本 CI 与 48 小时安全 SLA | 通过 GitHub Actions 在 Node.js 20、22 上执行自动化 CI,并取消并发任务;48 小时响应 / 5 天分诊 SLA | 确保跨平台稳定性、可靠的安全响应能力,以及无回归的软件分发 |
功能
- 19 个工具,全面管理 n8n 工作流
- 列出、创建、更新、删除和激活 / 停用工作流
- 安全控制:只读模式、删除 / 更新前备份、本地恢复和审计日志
- 多服务支持(连接多个 n8n 实例)
- 在服务之间导出 / 导入工作流
- 查看执行历史和状态
- 内置节点目录,附带说明
- 无 Python 依赖 -- 直接连接 n8n REST API
安装
Claude Desktop
添加到 claude_desktop_config.json:
{
"mcpServers": {
"n8n-manager": {
"command": "npx",
"args": ["-y", "n8n-manager-mcp"]
}
}
}
Claude Code
claude mcp add --scope user n8n-manager npx -y n8n-manager-mcp
手动安装
npm install -g n8n-manager-mcp
快速开始
安装后,在 AI 助手中使用以下命令:
-
添加你的 n8n 服务:
“添加我的 n8n 服务,地址为 http://localhost:5678,API 密钥为 abc123”
-
列出工作流:
“显示我的 n8n 服务上的所有工作流”
-
创建工作流:
“创建一个 n8n 工作流:由 webhook 触发,从 API 获取数据,然后发送 Slack 消息”
-
检查执行记录:
“显示最近 10 条工作流执行记录”
可用工具
| 工具 | 描述 |
|---|---|
n8n_list_workflows | 列出服务器上的所有工作流 |
n8n_get_workflow | 获取工作流详情(节点、连接) |
n8n_create_workflow | 根据节点和连接创建新工作流 |
n8n_update_workflow | 更新现有工作流 |
n8n_delete_workflow | 删除工作流 |
n8n_activate_workflow | 激活或停用工作流 |
n8n_list_executions | 列出近期执行记录及其状态 |
n8n_export_workflow | 将工作流导出为可导入的 JSON |
n8n_import_workflow | 将工作流 JSON 导入服务器 |
n8n_safety_status | 显示本地安全设置、备份目录和审计日志路径 |
n8n_set_safety_mode | 切换只读模式、变更前备份和审计日志记录 |
n8n_list_backups | 列出变更前创建的本地工作流备份 |
n8n_restore_workflow | 从本地备份恢复工作流 |
n8n_add_server | 添加或更新 n8n 服务器连接 |
n8n_list_servers | 列出已配置的服务器 |
n8n_ping_server | 测试服务器连接 |
n8n_remove_server | 移除服务器 |
n8n_describe_nodes | 浏览可用的 n8n 节点类型 |
n8n_manager_history | 从可选的 n8n-workflow-manager 读取版本历史、记录的决策和同步历史(需主动启用,只读) |
可选:n8n-workflow-manager 接口
n8n 本身不会记录工作流变更的原因。同属一个生态的项目
n8n-workflow-manager 会记录:
它会在本地数据库中保存版本、每次变更对应的必要决策,以及同步历史。n8n_manager_history 可通过此 MCP 服务读取这些记录。
此接口需主动启用,且为只读:
- 未设置
N8N_MCP_MANAGER_URL时,不会有任何变化——每个工具仍像以前一样直接与 n8n 通信。 - 设置该变量后(例如
http://127.0.0.1:8100),n8n_manager_history会从正在运行的管理器读取数据。省略workflow_id可列出管理器中的工作流,传入该参数则可获取完整历史。 - ID 是管理器 ID,而不是 n8n 实例 ID。管理器会保存两者的映射,但没有提供用于查询该映射的路由,因此此服务不会猜测转换结果。
- 如果已配置管理器但无法访问,该工具会返回明确错误信息,而不会悄悄改为从 n8n 实例读取——该存储不含决策历史,因此替代结果会是另一个答案。
n8n_safety_status报告接口的实际测量状态(是否已配置、是否可访问、管理器版本),而不只是环境变量的状态。
设置方法:运行 pip install n8n-workflow-manager,然后运行 n8n-manager serve(绑定到 127.0.0.1:8100)。
管理器 API 按设计无需身份验证,且仅监听环回地址;如果 URL 使用非环回地址,n8n_safety_status 会发出标记。
数值限制是 MCP 架构的一部分:工作流、执行记录和
备份列表的数量限制必须是有限的正整数,范围为 1 到 1000(现有默认值分别为 100、20 和 20);工作流连接的 from_output/
to_input 索引必须是有限的非负整数,范围为 0 到 1000。无效值会在访问任何 n8n API、文件系统或工作流数组前被拒绝。
配置
服务器连接和安全设置存储在 ~/.n8n-manager-mcp/servers.json 中。
安全默认设置:
backup_before_mutations: true会在更新、删除、激活/停用和覆盖恢复操作前保存工作流 JSON。audit_log: true会将变更操作结果追加到~/.n8n-manager-mcp/audit.log。read_only: false可通过n8n_set_safety_mode或N8N_MANAGER_READ_ONLY=1启用。 环境标志是强制执行上限:启用期间,持久化设置和n8n_set_safety_mode均无法关闭只读模式。- 备份存储在
~/.n8n-manager-mcp/backups/下,可通过备份工具列出/恢复。服务器/工作流名称会缩减为安全的单路径段;保留名称、分隔符、路径遍历以及符号链接/重解析点越界都无法逃出该根目录,并且列表只会公开常规.json备份。 - 保存前,
n8n_add_server会验证服务器连接输入:URL 必须是http或https基础 URL,且不得包含内嵌凭据、查询字符串或片段;API 密钥不得包含空白字符。 n8n_add_server的默认行为定义明确:第一个服务器会成为默认服务器;更新时若未指定is_default,则保留现有标志;true会将该服务器设为默认;false会有意移除其标志,之后默认服务器查询会回退到第一个已配置的服务器。
开发
npm install
npm run build # One-time build
npm run dev # Watch mode
npm start # Start server
npm test # Run test suite (vitest)
npm run smoke # Start the built MCP server and verify tool discovery
测试
测试套件涵盖 URL 构建、服务器输入验证、服务器管理、安全设置、备份路径处理、工作流 JSON 构建、导出/导入验证、i18n 语言包、仓库卫生检查以及错误处理。管理器接缝通过本地存根 HTTP 服务器进行测试,其中包括验证其不会回退到直接查询 n8n。
npm test # Run all tests
npx vitest run # Same as above
npx vitest --watch # Watch mode
npm run smoke # Manual stdio MCP smoke test (requires npm run build first)
当前验证记录涵盖本地 Windows 和 GitHub Actions 中的 Ubuntu Linux;GitHub Actions 会在 Node.js 20、22 和 24 上运行构建、测试和 npm 包检查。特定提交的本地记录保存在 CHANGELOG.md 中。冒烟测试运行器通过 MCP SDK 客户端启动 dist/index.js,验证全部 19 个工具注册,并调用安全的 n8n_describe_nodes 目录工具,无需 n8n 凭据。
贡献与开发工作流
欢迎贡献!请查看 CONTRIBUTING.md,了解完整指南,包括:
- 10 项治理与运行时不变量(
INV-LOCAL-01至INV-SLA-10):100% 本地优先、零外传、单调只读门控以及自动备份。 - 非特权用户模式(
RunAsInvoker):不请求任何管理员权限提升。 - Plan D 工作流:开发严格基于规范的本地克隆和 GitHub
origin/main。 - 48 小时安全响应 SLA:通过
[email protected]和[email protected]协调披露漏洞。
相关项目
- n8n-workflow-manager — 面向人类的状态与历史记录层(Web UI + REST API,Python):按工作流记录变更历史和决策日志、可视化图表查看器、多服务器同步。该项目专为与此 MCP 服务配套使用而设计——MCP 是 AI 操作层(创建/更新/删除/激活),manager 则用于审核、记录和回滚。**记忆与上下文(路线图):**单独的 MCP 服务无法 保证 Agent 在进行破坏性变更前检查既有上下文——这种强制机制应由 manager(与客户端无关)负责,对话上下文则可选地来自类似 ctx(Apache-2.0)的拉取式历史索引。计划:共享的历史/决策存储,以及一个 变更前检查历史记录 的防护机制。
- n8n -- 工作流自动化平台
许可证
MIT
ellmos-ai 生态系统
此 MCP 服务是 ellmos-ai 生态系统的一部分,涵盖 AI 基础设施、MCP 服务和智能工具。
MCP 服务系列
| 服务 | 工具 | 重点 | npm |
|---|---|---|---|
| FileCommander | 46 | 文件系统、进程管理、交互式会话、云锁安全操作 | ellmos-filecommander-mcp |
| CodeCommander | 22 | 代码分析、JSON 修复、导入、差异、正则表达式 | ellmos-codecommander-mcp |
| Clatcher | 12 | 文件修复、格式转换、批量操作 | ellmos-clatcher-mcp |
| n8n Manager | 19 | 通过 AI 助手管理 n8n 工作流 | n8n-manager-mcp |
| ControlCenter | 20 | MCP 技术栈发现、配置文件管理、控制平面 | ellmos-controlcenter-mcp |
| Homebase | 45 | 本地优先的大模型记忆、知识、状态、路由和集群编排 | ellmos-homebase-mcp(alpha) |
| ServerCommander | 8 | 服务操作:健康检查、日志分析、部署演练、邮件诊断 | ellmos-servercommander-mcp(alpha) |
| Blender Use | 3 | 无头 Blender 资源 QA 和 FBX 重新导入验证 | ellmos-blender-use-mcp(alpha) |
| Open Compute | 10 | 模型无关的计算机操作:捕获、安全门控操作、Windows UIA | open-compute-mcp(alpha) |
AI 基础设施
| 项目 | 描述 |
|---|---|
| BACH | 面向大模型 Agent 的本地优先文本操作系统——113+ 个处理器、550+ 个工具、SQLite 记忆 |
| open-compute | 为 Open Compute MCP 提供支持的模型无关计算机操作核心 |
| clutch | 与供应商无关的大模型编排,支持自动路由和预算跟踪 |
| rinnsal | 轻量级 Agent 记忆、连接器和自动化基础设施 |
| ellmos-stack | 可自托管的 AI 研究技术栈(Ollama + n8n + Rinnsal + KnowledgeDigest) |
| MarbleRun | 面向 Claude Code 的自主 Agent 链框架 |
| gardener | 极简的数据库驱动型大模型操作系统原型(4 个函数、1 张表) |
| ellmos-tests | 大模型操作系统测试框架(7 个维度) |
桌面软件与姊妹工具
我们的合作组织 open-bricks 和姊妹套件打包了 AI 原生桌面应用和开发者实用工具:
| 仓库 | 组织 / 套件 | 重点与功能 |
|---|---|---|
| ProFiler | file-bricks | 高级文件和资源管理工作台,支持重复项检测 |
| ExplorerPro | file-bricks | 支持标签页和筛选的文件管理器,具备智能批处理功能 |
| WinStorePackager | file-bricks | MSIX 打包和 Windows Store 发布准备 |
| DokuZen | doc-bricks | 离线 Markdown 编辑器,支持实时预览和文档结构整理 |
| PDFtoPDFocr | doc-bricks | 离线 OCR 流程,可将扫描版 PDF 文档转换为可搜索的 PDF |
| USR_PDFunlock | doc-bricks | 用于恢复受保护 PDF 档案生日 / 日期密码的工具 |
| UniversalInvoiceMail | doc-bricks | 自动提取发票并处理电子邮件 |
| CleanMarkdown | doc-bricks | 对技术 Markdown 进行无损格式和排版清理 |
| safe-start-for-codex | dev-bricks | 快速、可靠的 Agent 引导和环境检查运行器 |
| automation-master | dev-bricks | 集中式多主机自动化编排器和任务监控器 |
| DevCenter | dev-bricks | 面向本地工具链的统一开发者工作区仪表板 |
| CodeBox | dev-bricks | 沙箱化的多语言工具执行环境 |
| githubbot | dev-bricks | 自动化多组织仓库维护和可发现性引擎 |
| swarm-ai | ellmos-ai | 分布式多 Agent 群集框架,支持基于信息素的协调 |
| ellmos-core | ellmos-ai | 企业级 AI Agent 后端、混合 RAG 和多租户安全 |
| open-bricks | open-bricks | 汇集所有本地优先 AI 软件产品的综合门户和目录 |
| Zombie Killer Tray | dev-bricks | 用于检查孤立 MCP 进程的可选 Windows 工具。通过受支持的 node_modules/n8n-manager-mcp/dist/index.js 入口点启动时,n8n Manager 是一个已配置的候选项;仍须执行所有其他进程检查和应用检查 |
第三方许可证与透明度
本项目依据 MIT License 授权,归属声明见 NOTICE。 为确保在企业和自主 Agent 环境中实现完整的供应链完整性与合规性,所有依赖项均接受持续审计:
| 依赖项 | 类型 | 版本 | 许可证 | 验证状态 |
|---|---|---|---|---|
@modelcontextprotocol/sdk | 运行时(直接依赖) | ^1.29.0 | MIT | 宽松 / 已审计 |
zod | 运行时(直接依赖) | ^3.23.8 | MIT | 宽松 / 已审计 |
update-notifier | 运行时(直接依赖) | ^7.3.1 | BSD-2-Clause | 宽松 / 已审计 |
typescript | 开发 / 编译器 | ^5.3.3 | Apache-2.0 | 宽松 / 已审计 |
vitest | 开发 / 测试运行器 | ^4.1.11 | MIT | 宽松 / 已审计 |
@types/node | 开发 / 类型定义 | ^20.11.0 | MIT | 宽松 / 已审计 |
- 零 Copyleft / AGPL: 不包含传染性 Copyleft 或未经审查的商业依赖项。
- 零外部遥测: 不会发送网络信标、分析数据或外部回传请求。
- 详细的开源清单: 完整的归属声明、许可证文本和传递依赖分析见
THIRD_PARTY_LICENSES.md。 - Level 1 SBOM 纯文本配套文件: 完整的机器可读审计记录、非升级认证和许可证配套文件见
THIRD_PARTY_LICENSES.txt。
市场营销与用户画像日志
有关市场定位、目标用户画像定义、治理不变量映射和 3 阶段可发现性路线图,请参阅 MARKETING-LOG.txt。
更新日志
详细的版本历史、发行说明和过往迁移里程碑,请参阅 CHANGELOG.md。
责任 / 责任限制
法定声明与责任限制(《德国民法典》第 521 条)
本项目是《德国民法典》第 516 条及后续条款所指的无偿开源赠与。根据**《德国民法典》第 521 条**,作者仅对故意和重大过失承担责任。此外,适用 MIT License 中的责任免除条款。
使用风险由您自行承担。不承诺维护,不保证可用性,也不保证没有错误或适用于特定用途。
本项目是依据 MIT License 提供的无偿开源赠与。责任仅限于故意和重大过失(《德国民法典》第 521 条)。使用风险由您自行承担。不作任何保证,不保证提供维护,也不保证适用于特定用途。
安全响应 SLA 与漏洞报告
根据 SECURITY.md 的规定,我们执行严格且具有约束力的安全政策:
- 首次响应 SLA: 保证在 48 小时内响应(
INV-SLA-10)。 - 分类承诺: 在 5 个工作日内完成漏洞评估。
- 修复 SLA: 在 30 个日历日内提供协调发布的安全补丁。
- 直接联系邮箱:
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。