Yuxi

MCP运维云端

提供方 xerrors · 包名 yuxi

运维云端 stdio · 本地进程 未标注 社区 / 第三方 Claude DesktopCursorClineClaude Code
查看接入方式

结合知识库管理的 多租户 Agent Harness 平台。 An agent harness that integrates a LightRAG knowledge base and knowledge graphs. Build with LangChain v1 + Vue + FastAP

一句话选型结论

按资料字段整理

Yuxi 属于运维云端类 MCP 服务器,stdio · 本地进程,鉴权方式未标注,可直接接入 Claude Desktop、Cursor、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权未标注 部署方式本地部署
GitHub 星标 4,892 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

yuxi docker fastapi harness kbqa

支持客户端

适用场景

yuxidockerfastapi

安装与配置

stdio · 本地进程 未标注
客户端在本机拉起子进程,数据不出本机
docker

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Cursor、Cline,换客户端不用重新研究配置。
  • 仓库有一定关注度(星标 4,892),遇到问题更容易搜到资料。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Yuxi当前 未标注 stdio · 本地进程 本地部署 有 2026-04-11
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方xerrors上游标注的维护方 xerrors
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式未标注远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时yuxi · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-04-11上游最后核验时间

详细介绍

13.4 KB
来自项目仓库与上游目录的原文,未做删改

Yuxi = Cloud Agents + Knowledge RAG,Yuxi 是一个可私有部署的多租户知识智能体平台。自定义智能体,权限可控,沉淀企业轨迹。它把知识库检索、知识图谱、LangGraph 多智能体编排、MCP/Skills、沙盒工具和权限管理放进同一个工作区。让每个用户都拥有一个云端 Codex。

项目主页 · 快速开始 · 演示视频 · 版本记录 · English

Yuxi 能做什么

Yuxi 是面向需要企业自部署的多用户 Agent 产品,且需要自己掌握数据、模型和权限的团队:

  • 二开友好:MIT 协议、代码简洁、可拓展性强、高并发部署友好。
  • Harness:功能完善的云端多用户 Harness,自定义智能体,沉淀企业轨迹。
  • Knowledge: 高效、精准的 Agentic RAG 套件,上传文档,解析、分块和向量索引。
  • 执行多步骤任务:组合工具、MCP、Skills、子智能体和沙盒,产出可预览、可下载的文件。
  • 连接知识图谱:从 Milvus 知识库的文档块中抽取实体和关系,写入 Neo4j 并参与检索。
  • 管理团队使用范围:按用户、部门和共享范围管理知识库、智能体、Skills 和模型。
  • 对比运行质量:评估知识库的检索结果;完整智能体评估可通过公开 API 自行构建,见智能体评估。

赞助商

赞助商 介绍
Fluxion AI面向个人开发者、技术团队与企业,通过统一API接入并管理全球主流AI模型;通过多线路动态调度提升可用性,模型表现、响应时间与费用透明可查。根据不同模型与线路,API调用成本较官方或基准价格可降低40%—98%。专属链接注册 获 $7 API 额度

快速启动

语析(Yuxi)默认使用 Docker Compose 和 Container 沙盒启动。每段智能体执行使用独立临时容器,工作目录文件持久保留,无需额外准备 KVM 节点。

前置条件

安装 Git、Docker Engine 和 Docker Compose v2,准备一个可用的大模型 API。macOS/Windows 使用 Docker Desktop 的 Linux 容器模式,并允许项目目录共享。

本教程使用 v0.8.0.beta5 测试版本。0.8 仅面向全新部署,旧数据库、索引和文件布局不提供自动升级;请用独立数据目录试用,见0.8.0 更新说明。

Container 适合本地试用和单租户可信代码,共享宿主内核。需要 VM 隔离或持久用户环境时,在快速开始选择 Cube 并准备 Linux/KVM 执行节点。

1. 获取代码并初始化```bash

git clone --branch v0.8.0.beta5 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi
./scripts/init.sh


Windows 在 PowerShell 中运行 `.\scripts\init.ps1`。脚本提示填写 SiliconFlow API Key,生成独立的应用安全密钥、runner 认证密钥和实例标识,并准备基础镜像。其他模型供应商可在登录后配置。已有 `.env` 时保留原密钥;切换到 Container 需设置 `SANDBOX_BACKEND=container` 后重新运行初始化。

### 2. 启动服务```bash
docker compose --profile container config --quiet
docker compose --profile container up --build -d

container profile 会构建沙盒镜像并启动 runner。默认禁止沙盒联网,适用范围与配置见Container 沙盒。

3. 验证部署```bash

docker compose --profile container ps
curl --fail http://localhost:5050/api/system/ready
```

返回的 status 为 ready 后,打开 http://localhost:5173,初始化超级管理员并登录。在智能体中执行创建 hello.txt 的任务,并在工作区核对文件内容;完整操作见快速开始。API 文档位于 http://localhost:5050/docs。

文档导航

  • 项目介绍:了解能力、概念和系统边界。
  • 快速开始:选择沙盒并启动开发环境。
  • 命令行工具:登录实例、对话、发送附件和查询知识库。
  • 公开 Agent API 入门:外部应用创建会话、提交消息和读取结果。
  • 模型配置:接入聊天、嵌入和重排模型。
  • 知识库教程:创建知识库并验证检索。
  • 智能体开发:配置 Agent、工具和扩展。
  • 生产部署:部署、升级、备份和排障。
  • 版本变更记录:查看已发布变更。

能力展示

Yuxi 把知识进入系统、Agent 执行任务和团队治理放在一条完整链路中。以下按六个核心模块介绍系统能力:

模块 解决的问题 代表能力
统一智能体工作台 在一个界面完成提问、执行与交付 多轮对话、知识库检索、任务状态、人工审批
知识库与 RAG 为回答提供检索内容 多格式入库、Embedding/Rerank、检索测试、RAG 评估
知识图谱与知识导图 发现实体关系并浏览知识库文件结构 图谱构建、子图浏览、节点详情、文件元数据导图
多智能体与扩展生态 把复杂任务拆给不同角色和工具 SubAgents、Skills、MCP、Tools、Agent 配置
沙盒工作区与产物 把对话结果变成可继续使用的文件 隔离文件系统、文件生成、在线预览、下载
团队治理与运行管理 在多人环境中管理能力、权限和运行状态 多租户、用户与部门权限、模型配置、API Key、Dashboard

01 · 统一智能体工作台

用户可以在同一个对话界面里引用知识库文档、个人文件或扩展 Skill;查看任务执行状态,并在对话中获取回答或生成的文件。

  • 支持使用 @ 快速引入知识库、文件与特定 Skill。
  • 展示任务拆解步骤、工具调用状态与上下文 Token 消耗。
  • 支持预览和下载生成的文件产物。

展开详细截图:对话、执行状态与人工审批

长任务执行状态与过程追踪

后台异步执行复杂任务时,界面会实时呈现智能体的思考链路、步骤计划、子任务状态与工具调用日志,不再让长任务变成黑盒等待。

人工审批与交付卡片

默认审批模式要求确认命令执行和当前 Project 外的文件写入,Project 内写入自动放行;完全信任模式不要求审批。任务完成后,用户可以通过交付卡片预览或保存文件。

02 · 知识库与 RAG

支持将团队各类资料集中管理并解析为结构化知识库。Agent 可以检索相关文档片段,作为回答问题的上下文。

  • 集中管理文件与目录结构,实时查看解析进度、Chunk 切片与 Token 统计。
  • 支持配置 Embedding 与 Rerank 算法,并在后台直接进行多路召回测试与调优。
  • 内置 RAG 效果评估工具,通过实际问答集量化测试知识库检索与回答质量。

展开详细截图:入库、检索与评估

文档解析与切片管理

支持 PDF、Word、PPT、Excel、Markdown 等多种常见文档格式。内置 MinerU、PaddleX、RapidOCR 等解析引擎,提取文本、图片和表格内容并切分为 Chunk,生成向量索引供检索使用。

知识库类型与外部数据源

除了开箱即用的本地向量知识库,系统还支持直接连接 Dify、Notion 等外部知识库服务,通过统一检索器供 Agent 调用。

检索测试与重排序(Rerank)

提供直观的检索测试工作台。输入测试 Query 即可实时查看 Embedding 向量初筛得分、混合检索结果以及 Rerank 重排序后的分数变化,方便直观验证召回效果。

RAG 效果评估

支持构建基准问答评估集并批量评测检索召回率;提供参考答案和评判模型时,还可评估答案准确性,帮助发现知识盲区与配置短板。

自动生成单条 QA 和多跳 QA

03 · 知识图谱与知识导图

从非结构化文档中抽取实体与关系,构建知识图谱。既支持在交互式拓扑图谱中探索实体关联,也支持根据文件层级和主题元数据自动生成清晰的知识导图。

  • 从知识库中自动抽取实体与关系,在 Milvus/Neo4j 中构建知识图谱索引。
  • 支持按关键词搜索实体、点击节点查看属性详情,并高亮探索关联子图。
  • 结合知识库文件元数据自动生成多层级知识导图,浏览知识库结构。

展开详细截图:图谱构建、节点关系与知识导图

图谱构建与索引状态

管理员对已索引的 Milvus 文档块提交构建任务后,系统执行实体识别与关系抽取并写入 Neo4j。图谱构建不随文档解析自动触发,用户可查看实体、关系与后台任务进度。

知识导图

基于文件的目录结构、分类标签与元数据特征,自动生成结构化的主题脑图/知识导图,方便用户以树状脉络快速浏览海量知识内容。

04 · 多智能体与扩展生态

一个 Agent 可以灵活组合模型、提示词、知识库、外部工具与专用子智能体。面对复杂任务,主智能体负责规划拆解,多个 SubAgents 分头异步并行执行,Skills 与 MCP 协议提供能力扩展。

  • 自由配置 Agent 的基座模型、知识挂载、工具调用与系统提示词。
  • 支持多个 SubAgents 异步并行执行深度调研、数据分析或内容生成。
  • 原生兼容 Skills 插件机制与 MCP(Model Context Protocol)标准协议。

展开详细截图:Agent 配置、子智能体与扩展能力

Agent 配置与行为定制

智能体提供丰富的模块化配置项,可以按需组合大模型、挂载的知识库、自定义 Tools、MCP 服务、前置提示词与子智能体,并支持灵活配置在部门或团队内的共享可见范围。

子智能体并行执行

支持主智能体将复杂的多步骤任务拆解后,派出多个专属 SubAgent 异步并行跑任务(例如分头检索不同领域的法规、分别撰写报告不同章节),执行完毕后汇总结果。

Skills、MCP 与生态扩展

统一接入并管理 Skills 扩展技能与 MCP Servers 外部协议,支持针对不同角色分配权限与使用范围;借助渐进式披露机制,在真正需要时按需动态解析并加载工具。Skill 在线安装支持 skills.sh 以及魔搭社区的 skill。

可以查看并在线编辑 skill

可以配置 skill 权限和依赖

内置工具列表

05 · 沙盒工作区与文件产物

智能体可以通过沙盒工具读写文件。智能体不仅能在对话中回答问题,还能把分析研究成果沉淀为 Markdown 文档、数据表格、HTML 页面或可执行代码,并在工作区中随时查看与下载。

  • 通过沙盒限制工具可访问的文件范围。
  • 支持生成图文报告、数据分析图表、Web 页面等多种格式产物。
  • 在浏览器中预览受支持的文件格式,并打包下载。

展开详细截图:文件管理、在线预览与任务交付

工作区文件管理

可视化管理任务在工作区中读取与产生的文件,清晰展示目录层级、文件类型与体积大小,方便在会话之间复用中间产物。

HTML、PDF、图表与代码在线预览

智能体生成的报告文档、可视化 HTML 网页、图片图表或代码脚本,无需下载即可直接在浏览器内置的预览器中渲染并进行交互查看。markdown 还支持在线编辑保存。

对话中的文件交付

任务执行完毕后,对话气泡中会生成结构化的交付卡片,直观呈现文件摘要、格式与操作按钮,支持直接打开预览或保存到本地。

06 · 团队治理与运行管理

专为企业和团队多人协作打造。管理员可以集中管理成员与部门组织架构、统一配置模型接入凭据与 API Key,并通过监控看板查看平台的运行状况与调用指标。

  • 支持按用户、部门和共享范围配置知识库、Agent 等资源的访问与管理权限。
  • 集中配置和调度多供应商的大模型能力,统一管理 API Key 凭据。
  • 实时统计分析使用量、请求趋势与资源负载,辅助运行维护。

展开详细截图:权限、模型与运行数据

用户、部门与细粒度权限体系

通过用户、部门和资源共享范围控制知识库、智能体等资源的访问与管理权限;沙盒工作区按用户隔离。

模型供应商与统一凭据管理

支持接入主流大模型供应商(OpenAI、Anthropic、DeepSeek、Qwen 及 OpenAI 兼容自建端点如 vLLM 等),集中维护 API Key 凭据并统一分配模型能力,密钥对普通成员完全脱敏。

Dashboard 与系统运行监控

运维数据看板展示会话、模型和工具调用、Token 消耗以及 VM 状态等统计,为容量规划和成本核算提供数据支撑。

参与贡献

欢迎提交 Issue、改进文档、修复 Bug 和贡献功能。开发流程见 CONTRIBUTING.md,完整规范见 文档参与指南。

感谢所有贡献者的支持!


许可证

Yuxi 本体采用 MIT License,详见 LICENSE。Docker Compose 引入的第三方组件遵循各自的许可证;再分发和商业部署前,请按实际镜像版本核对上游许可和源码义务,相关边界见生产部署指南。

Yuxi 的实现和文档参考了以下优秀的开源项目:

  • LightRAG:早期图谱构建和检索思路;
  • DeepAgents:深度智能体框架;
  • DeerFlow:沙盒智能体架构思路;
  • RAGFlow:文档分块策略;
  • LangGraph:智能体编排基础;
  • QwenPaw:模型配置和个人文件区域设计。

Star History

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Yuxi 怎么安装?

在客户端按下面的安装命令接入:docker。对应的包名是 yuxi。装完在客户端配置里引用同一个包或端点。

Yuxi 怎么在 Claude Desktop、Cursor、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Yuxi 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Yuxi 需要 API Key 吗?

资料没有标注鉴权方式,是否需要密钥取决于服务本身,接入前按官方文档确认。

Yuxi 支持哪些客户端?

资料标注支持 Claude Desktop、Cursor、Cline、Claude Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Yuxi 能提供哪些能力?

资料显示能力标签包括 yuxi、docker、fastapi、harness、kbqa。具体工具清单以官方文档为准。

Yuxi 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

Yuxi 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-04-11。