MUXI AI 应用服务器

用可部署的 Agent 编排、记忆与运维基础设施,把 AI 系统投入生产。

源仓库
muxi-ai/muxi
Star 数
★ 189
最近更新
12 天前
License
NOASSERTION

30 秒速览

运行形态
命令行工具自托管服务MCP 服务器
可在哪里用
通用 · 跨平台Claude Code · OpenAI API · Claude API(部分支持)
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Shell / 命令行网络访问本地文件系统MCP Server
典型场景
为 SaaS 产品增加 AI 功能的平台团队,可用 formation 定义 agents,并由一套服务器提供用户隔离和记忆。
不适合
  • 只想安装一个现成聊天机器人的用户
  • 不愿维护自托管服务器的团队

这个 Agent 能做什么,适合哪些场景?

MUXI 是一套自托管 AI 应用服务器,包含 Server、Runtime 和 CLI,以 agent formation 作为可声明、可部署的系统定义。Formation 可打包 agents、知识、记忆、工具、工作流、触发器、策略和运行行为,并由 Overlord 路由请求、协调 agents 与执行工作流。部署后,系统可通过 REST、SSE、MCP 和十二种官方 SDK 访问。它提供分层且可审计的记忆、多租户隔离、组级 RBAC、观测能力和运行韧性等基础设施。适合需要自行部署完整 Agent 系统的平台团队和组织;需要现成托管服务的用户应注意,README 描述的是自托管路径。

用户用 muxi pull 获取 formation,通过 .afs YAML 文件定义系统和 agents,再运行 muxi deploy。Server 与 Runtime 执行 formation:Overlord 路由请求、选择 SOP、分解复杂任务并协调 agents;系统可检索本地或远程知识源、调用工具和 MCP 服务,并处理工作流与触发器。记忆以分层、带作用域的事件形式记录,支持来源追踪、重建和选择性遗忘。Formation 可通过 muxi chat、REST、SSE、MCP 或 SDK 接收请求和流式返回结果;也可作为 MCP server 暴露给其他客户端。

  1. 为 SaaS 产品增加 AI 功能的平台团队,可用 formation 定义 agents,并由一套服务器提供用户隔离和记忆。
  2. 需要让不同员工或团队使用内部 AI 工具的组织,可配置组继承以及 agent、MCP 服务和单项工具的访问规则。
  3. 需要处理产品文档和远程资料的团队,可配置知识源、层级与向量检索,并用 formation 回答请求。
  4. 需要让 Agent 定时或响应外部事件工作的团队,可设置心跳、活动时段、计划任务或 webhook 触发器及结果路由。
  5. 希望通过标准接口将 Agent 接入其他客户端的开发者,可使用 MCP 暴露 formation,或通过十二种 SDK 调用服务。

如何安装或部署这个 Agent?

README 提供 macOS、Linux 和 Windows 的 CLI 安装命令。安装后还需拉取 formation 并部署;示例 formation 使用 OpenAI 模型并从 OPENAI_API_KEY 读取密钥。README 没有列出服务器运行所需的完整系统依赖清单。

如何使用这个 Agent?

先安装 CLI,再拉取并部署示例 formation:

brew install muxi-ai/tap/muxi
muxi pull @muxi/hello-muxi
muxi deploy
muxi chat hello-muxi

Linux 安装方式:

curl -fsSL https://muxi.org/install | sudo bash

Windows 安装方式:

irm https://muxi.org/install | iex

formation 可用 YAML 定义模型、密钥和 agents;使用示例中的 OpenAI 配置时,部署环境需提供 OPENAI_API_KEY:

schema: "1.0.0"
id: "customer-support"
description: Helps customers with product support and refunds
llm:
  models:
    - text: "openai/gpt-4o"
  api_keys:
    openai: "${{ secrets.OPENAI_API_KEY }}"
agents:
  - sales-assistant

Python SDK 示例使用 FormationClient 和客户端密钥连接本地服务器:

from muxi import FormationClient

client = FormationClient(
    server_url="http://localhost:7890",
    formation_id="hello-muxi",
    client_key="<your-client-key>"
)

for chunk in client.chat_stream({ "message": "Hello!" }, user_id="user_123"):
    print(chunk.get("text", ""), end="")

这个 Agent 有哪些优点和局限?

优点
  • Formation 将 agents、知识、记忆、工具和运行配置打包成一个可部署单元,且有 CLI 部署流程。
  • 提供带作用域和不可变事件的记忆能力,并支持来源追踪、重建与选择性遗忘。
  • 支持组级 RBAC、多租户隔离、每用户凭据和可供外部客户端连接的 MCP 接口。
  • README 列出十二种语言的官方 SDK,并支持 REST、SSE 和 MCP 访问。
局限
  • 采用 Server、Runtime、CLI 和 formation 的完整栈,部署和运维成本高于只引入一个 Python 框架或库。
  • README 示例使用 OpenAI 模型并要求提供 API 密钥;模型调用可能产生外部服务费用。
  • Server 与 Runtime 使用 ELv2 许可,README 说明限制之一是不能将 MUXI 本身作为托管服务转售。
  • README 未说明完整系统依赖、资源需求或离线模型配置步骤,需在采用前核实部署环境。

这个 Agent 与同类方案有什么区别?

README 将 MUXI 与 LangChain/LangGraph、CrewAI 和 AutoGen 对比:它定位为服务器基础设施,以 formation 声明配置并负责部署与运维;这些项目则被描述为 Python 库或框架,部署和多租户能力由应用自行实现。此对比反映 README 的定位,不代表独立性能评测。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
MUXI AI 应用服务器 当前 59 · 缺口较多 命令行工具免费 + 模型费 ★ 189 12 天前 — —
Archestra 71 · 存在缺口 自托管服务免费版 + 付费版 ★ 4.4k 今天 TypeScript Codex · Claude Code · OpenAI API · Claude API
Manifold 60 · 存在缺口 自托管服务免费 ★ 502 2 个月前 Go OpenAI API · Claude API
taOS 自托管智能体操作系统 71 · 存在缺口 自托管服务免费 ★ 557 9 天前 Python Claude Code · OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
59/ 100 五分制 3.0 / 5
信任安全 14/29
可靠稳定 6/14
适用触发 14/18
规范维护 11/18
有效结果 10/13
证据核验 4/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

README 描述了用户隔离、加密凭据、RBAC、PII/密钥脱敏及部署回滚;自调优方案由用户决定是否应用,支持用户控制。扣分原因:这些安全能力主要是产品声明,所给材料缺少实现细节;Quick Start 的 Linux 安装以 sudo 执行远程脚本,且触发器可向外部渠道路由结果,但未说明这些外部副作用的确认或回滚流程。安全报告渠道明确,但没有披露依赖审计或来源验证机制。

可靠稳定6 / 14 · 2.1/5

README 将 Server、Runtime、CLI、Formation API 和 SDK 描述为协调版本,并提到熔断、退避、降级、幂等及回滚,提供了部分一致性与恢复依据。扣分原因:支持这些声明的实现或运行细节不在所给文件中;多组件安装依赖外部仓库和文档,未见失败诊断或依赖可用性安排。

适用触发14 / 18 · 3.9/5

README 明确面向平台构建者、内部工具构建者和希望减少框架运维工作的开发者,并列出 REST、SSE、MCP、多模型及多语言 SDK 等场景。扣分原因:场景覆盖广,但对能力边界、资源需求和不适用情形说明有限;触发器与部署示例清楚,但其精确行为和环境前提仍主要依赖外部文档。

规范维护11 / 18 · 3.1/5

README 的产品介绍、快速开始、示例、文档索引和贡献入口组织清楚;包含 macOS、Linux、Windows 安装命令及组件级许可证说明,并标明稳定 1.x。扣分原因:许可证元数据为 NOASSERTION,仓库文档则描述 Server/Runtime 为 ELv2、其余组件为 Apache 2.0,需按组件核实;未提供本材料中的详细变更记录、限制清单或明确维护责任,发布入口指向多个仓库。

有效结果10 / 13 · 3.8/5

快速开始给出拉取、部署、对话的可执行路径,Formation 与 SDK 示例展示配置和集成方式;平台主张的内存、编排、RBAC 和观测功能可减少自建基础设施工作。扣分原因:示例规模小,未体现生产部署所需配置或成本;效益主张多为 README 概述,未有此材料中的量化或独立佐证。

证据核验4 / 8 · 2.5/5

README 将多数关键功能链接到具体概念文档,并给出配置片段;LICENSE.md 和 SECURITY.md 分别提供许可说明与漏洞报告渠道。扣分原因:所给材料没有这些外链文档的内容,也没有代码、测试或独立来源与功能声明交叉印证;因此只能评估声明的可追踪性,不能把它们视为已验证实现。

风险与缓解建议
  • Linux 快速安装命令通过 sudo 执行远程脚本;部署前应审阅脚本来源及其权限范围。
  • 许可证元数据为 NOASSERTION。README 和 LICENSE.md 将不同组件分为 ELv2 与 Apache 2.0,使用前应核对实际部署组件及适用条款。
  • 有关安全、隔离、加密、脱敏和回滚的描述在所给材料中未附实现证据;不要将产品说明等同于独立验证。
证据充分度:低 评估于 2026年10月10日 审查版本 bfb709f9d0ca
查看完整评分方法 →

常见问题

使用 MUXI 是否需要付费?
README 称 MUXI 可自由用于产品和业务,但模型服务可能需要自备 API 密钥并产生按量费用。Server 与 Runtime 使用 ELv2,不能把 MUXI 本身作为托管服务转售。
可以完全在自己的基础设施上运行吗?
可以。README 将 MUXI 描述为自托管服务器,并称数据可留在自己的基础设施上;具体部署依赖项和离线模型步骤未在所给 README 中列明。
如何把已部署的 formation 接到现有系统?
可通过 REST、SSE、MCP 或十二种官方 SDK 访问;Python 示例使用 FormationClient、服务器地址、formation ID 和客户端密钥。
如何限制用户可以访问的 agents 和工具?
README 描述了组级 RBAC、继承,以及针对 agents、MCP 服务和单个工具的允许或拒绝规则;外部成员身份解析采用 fail-closed 行为。
工作流或模型调用失败时,系统提供什么处理?
README 列出断路器、备用模型、指数退避、优雅降级和幂等键等韧性机制;具体行为取决于 formation 与部署配置。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents