# Yunxing Ai

> 云行 AI 是一个功能强大的 AI 应用构建平台，旨在简化 AI 应用的开发和部署过程。通过提供丰富的工具和接口，开发者可以快速构建、定制和部署 AI 解决方案。

- **Type:** MCP server
- **Install:** `agentstack add mcp-boyazuo-yunxing-ai`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [boyazuo](https://agentstack.voostack.com/s/boyazuo)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [boyazuo](https://github.com/boyazuo)
- **Source:** https://github.com/boyazuo/yunxing-ai

## Install

```sh
agentstack add mcp-boyazuo-yunxing-ai
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 云行 AI - AI 应用构建平台

云行 AI 是一个功能强大的 AI 应用构建平台，旨在简化 AI 应用的开发和部署过程。通过提供丰富的工具和接口，开发者可以快速构建、定制和部署 AI 解决方案。

## 界面展示

## 核心功能

- **账户与权限**：多租户（工作空间）管理、用户认证、团队成员与邀请
- **AI 应用构建**：应用创建与配置、系统提示词、变量、知识库绑定
- **对话能力**：流式对话（SSE）、会话与消息管理
- **知识库（RAG）**：文档上传与解析（PDF / Word）、多种分段策略、向量检索、严格模式问答
- **文件管理**：本地 / 阿里云 OSS 文件存储

## 项目架构

项目采用前后端分离架构：

### 前端架构

- **框架**：[Next.js 15.3](https://nextjs.org)（App Router）+ Turbopack
- **语言**：TypeScript、React 19
- **UI 组件**：[shadcn/ui](https://ui.shadcn.com/)、[Radix UI](https://www.radix-ui.com/)
- **样式**：[TailwindCSS 4](https://tailwindcss.com/)
- **状态管理**：React Hooks
- **表单处理**：react-hook-form + zod 验证
- **国际化**：next-intl 4
- **认证**：next-auth 4
- **HTTP 请求**：axios
- **UI 动画**：framer-motion
- **Markdown 渲染**：react-markdown + remark-gfm
- **图标**：lucide-react + react-icons
- **提示通知**：sonner
- **代码格式化**：Biome
- **包管理工具**：pnpm

### 后端架构

- **语言**：Java 17
- **框架**：Spring Boot 3.5
- **安全认证**：Spring Security + JWT（jjwt 0.12.6）
- **数据库**：MySQL 8.3 + MyBatis-Flex 1.10.9
- **连接池**：Druid 1.2.24
- **缓存**：Redis
- **向量数据库**：Qdrant（Spring AI Vector Store）
- **工具库**：Hutool 5.8.36、Lombok
- **API 文档**：SpringDoc OpenAPI 2.8.6
- **HTTP 客户端**：OkHttp
- **云存储**：阿里云 OSS
- **响应式编程**：WebFlux、Reactor（流式对话）
- **AI 集成**：Spring AI 1.1.6（智谱 AI、Ollama、OpenAI 兼容 / DashScope）
- **文档处理**：Apache PDFBox、Apache POI
- **邮件服务**：Spring Mail

## 目录结构

```
yunxing-ai/
├── web/                          # 前端代码
│   ├── app/                      # Next.js App Router
│   │   ├── [locale]/             # 国际化路由
│   │   │   ├── (auth)/           # 登录、注册
│   │   │   └── (main)/           # 主界面（应用、知识库、设置等）
│   │   └── api/                  # NextAuth 等 API 路由
│   ├── components/               # 可复用 UI 组件
│   ├── lib/                      # 工具函数与 API 客户端
│   ├── hooks/                    # 自定义 React Hooks
│   ├── i18n/                     # 国际化配置
│   ├── types/                    # TypeScript 类型定义
│   ├── api/                      # 后端 API 封装
│   └── public/                   # 静态资源
│
├── api/                          # Java 后端服务
│   ├── src/main/java/com/yxboot/
│   │   ├── common/               # 通用工具、异常、统一响应
│   │   ├── config/               # 安全、Web、上传等配置
│   │   ├── ai/                   # AI 能力（Spring AI、RAG、文档处理、向量存储）
│   │   ├── modules/              # 业务模块
│   │   │   ├── account/          # 账户权限（租户、用户、邀请）
│   │   │   ├── app/              # AI 应用与配置
│   │   │   ├── dataset/          # 知识库、文档、分段
│   │   │   ├── ai/               # 对话、会话、消息
│   │   │   └── system/           # 系统（文件、邮件）
│   │   ├── util/                 # 工具类
│   │   └── ApiApplication.java   # 应用入口
│   └── pom.xml
│
└── doc/                          # 项目文档
    ├── sql/                      # 数据库脚本与迁移
    ├── dev_log/                  # 开发日志
    └── weekly/                   # 开发周刊
```

## 数据库结构

系统采用 MySQL 8.3，主要表结构包括：

- **账户管理**：`tenant`（租户）、`user`（用户）、`tenant_user`（租户成员）、`invitation`（邀请）
- **应用管理**：`app`（应用）、`app_config`（应用配置）
- **对话管理**：`conversation`（会话）、`message`（消息）
- **知识库**：`dataset`（知识库）、`dataset_document`（文档）、`dataset_document_segment`（文档分段）
- **系统**：`sys_file`（附件）

完整建表脚本见 [`doc/sql/db_schema.sql`](doc/sql/db_schema.sql)。已有数据库升级请按 [`doc/sql/`](doc/sql/) 下的迁移脚本顺序执行。

## 开发环境搭建

### 前置依赖

| 组件 | 版本要求 | 说明 |
|------|----------|------|
| Node.js | 20+ | 前端运行环境 |
| pnpm | 最新 | 前端包管理 |
| JDK | 17+ | 后端运行环境 |
| Maven | 3.8+ | 后端构建 |
| MySQL | 8.3+ | 业务数据 |
| Redis | 7.0+ | 缓存 |
| Qdrant | 最新 | 向量存储（默认端口 6334） |

### 数据库初始化

```bash
# 创建数据库
mysql -u root -p -e "CREATE DATABASE yxboot DEFAULT CHARACTER SET utf8mb4;"

# 导入表结构
mysql -u root -p yxboot

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [boyazuo](https://github.com/boyazuo)
- **Source:** [boyazuo/yunxing-ai](https://github.com/boyazuo/yunxing-ai)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-boyazuo-yunxing-ai
- Seller: https://agentstack.voostack.com/s/boyazuo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
