mcpField
N
n8n Manager MCP

n8n Manager MCP

本地服务
github.com生产力21 天前更新

关于 n8n Manager MCP

n8n Manager MCP 连接 AI 助手与 n8n 实例,用于管理工作流。它结合多实例路由、变更前快照和离线节点目录,并设有安全检查。

主要功能

  1. 01创建、查看和管理 n8n 工作流
  2. 02在多个 n8n 实例间路由请求
  3. 03工作流变更前创建快照
  4. 04通过离线目录查看节点结构
  5. 05导出和导入工作流

适用场景

  1. 01通过 AI 助手创建或检查 n8n 工作流
  2. 02在开发和生产实例间迁移工作流
  3. 03无需 API 调用即可查看节点结构
  4. 04从本地快照恢复工作流

MCP 相关

本地 stdio MCP 服务提供工作流操作、执行记录、备份和节点相关工具。它将请求路由到已配置的 n8n 实例,并对变更操作执行安全检查。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
"mcpServers": {
"ellmos-ai-n8n-manager": {
"command": "npx",
"args": [
"-y",
"n8n-manager-mcp"
]
}
}
}
启动命令npx -y n8n-manager-mcp

本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。

安装包
npmn8n-manager-mcp0.1.20

工具

18

收录的工具列表 · 更新于 3 天前

此工具无需参数。

详细介绍

n8n Manager MCP 服务横幅

n8n Manager MCP 服务

🇩🇪 德语版

属于 ellmos-ai 家族及 open-bricks 旗下项目。

npm Tests MCP Tools Node.js Safety Security Third-Party Level 1 SBOM: Plain Text Attribution: NOTICE Verified Last-Checked License: MIT LLM Ready Ecosystem: ellmos--ai Umbrella: 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 code
  • ai assistant n8n workflow management
  • local-first n8n mcp stdio
  • safe n8n automated workflow mutation
  • n8n multi-server workflow sync mcp
  • n8n describe nodes offline catalog
  • zero-egress n8n agent automation
  • modelcontextprotocol 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-01100% 本地优先,零数据外流使用 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 助手中使用以下命令:

  1. 添加你的 n8n 服务:

    “添加我的 n8n 服务,地址为 http://localhost:5678,API 密钥为 abc123”

  2. 列出工作流:

    “显示我的 n8n 服务上的所有工作流”

  3. 创建工作流:

    “创建一个 n8n 工作流:由 webhook 触发,从 API 获取数据,然后发送 Slack 消息”

  4. 检查执行记录:

    “显示最近 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
FileCommander46文件系统、进程管理、交互式会话、云锁安全操作ellmos-filecommander-mcp
CodeCommander22代码分析、JSON 修复、导入、差异、正则表达式ellmos-codecommander-mcp
Clatcher12文件修复、格式转换、批量操作ellmos-clatcher-mcp
n8n Manager19通过 AI 助手管理 n8n 工作流n8n-manager-mcp
ControlCenter20MCP 技术栈发现、配置文件管理、控制平面ellmos-controlcenter-mcp
Homebase45本地优先的大模型记忆、知识、状态、路由和集群编排ellmos-homebase-mcp(alpha)
ServerCommander8服务操作:健康检查、日志分析、部署演练、邮件诊断ellmos-servercommander-mcp(alpha)
Blender Use3无头 Blender 资源 QA 和 FBX 重新导入验证ellmos-blender-use-mcp(alpha)
Open Compute10模型无关的计算机操作:捕获、安全门控操作、Windows UIAopen-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 原生桌面应用和开发者实用工具:

仓库组织 / 套件重点与功能
ProFilerfile-bricks高级文件和资源管理工作台,支持重复项检测
ExplorerProfile-bricks支持标签页和筛选的文件管理器,具备智能批处理功能
WinStorePackagerfile-bricksMSIX 打包和 Windows Store 发布准备
DokuZendoc-bricks离线 Markdown 编辑器,支持实时预览和文档结构整理
PDFtoPDFocrdoc-bricks离线 OCR 流程,可将扫描版 PDF 文档转换为可搜索的 PDF
USR_PDFunlockdoc-bricks用于恢复受保护 PDF 档案生日 / 日期密码的工具
UniversalInvoiceMaildoc-bricks自动提取发票并处理电子邮件
CleanMarkdowndoc-bricks对技术 Markdown 进行无损格式和排版清理
safe-start-for-codexdev-bricks快速、可靠的 Agent 引导和环境检查运行器
automation-masterdev-bricks集中式多主机自动化编排器和任务监控器
DevCenterdev-bricks面向本地工具链的统一开发者工作区仪表板
CodeBoxdev-bricks沙箱化的多语言工具执行环境
githubbotdev-bricks自动化多组织仓库维护和可发现性引擎
swarm-aiellmos-ai分布式多 Agent 群集框架,支持基于信息素的协调
ellmos-coreellmos-ai企业级 AI Agent 后端、混合 RAG 和多租户安全
open-bricksopen-bricks汇集所有本地优先 AI 软件产品的综合门户和目录
Zombie Killer Traydev-bricks用于检查孤立 MCP 进程的可选 Windows 工具。通过受支持的 node_modules/n8n-manager-mcp/dist/index.js 入口点启动时,n8n Manager 是一个已配置的候选项;仍须执行所有其他进程检查和应用检查

第三方许可证与透明度

本项目依据 MIT License 授权,归属声明见 NOTICE。 为确保在企业和自主 Agent 环境中实现完整的供应链完整性与合规性,所有依赖项均接受持续审计:

依赖项类型版本许可证验证状态
@modelcontextprotocol/sdk运行时(直接依赖)^1.29.0MIT宽松 / 已审计
zod运行时(直接依赖)^3.23.8MIT宽松 / 已审计
update-notifier运行时(直接依赖)^7.3.1BSD-2-Clause宽松 / 已审计
typescript开发 / 编译器^5.3.3Apache-2.0宽松 / 已审计
vitest开发 / 测试运行器^4.1.11MIT宽松 / 已审计
@types/node开发 / 类型定义^20.11.0MIT宽松 / 已审计
  • 零 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 个日历日内提供协调发布的安全补丁。
  • 直接联系邮箱:

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。