# mams

**Repository Path**: zp-learning/mams

## Basic Information

- **Project Name**: mams
- **Description**: MAMS 是一个面向企业与团队的多智能体管理平台，提供从模型接入、Agent 配置、工具编排、对话调用到运行监控的完整闭环能力。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-29
- **Last Updated**: 2026-04-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# MAMS - Multi-Agent Management System

MAMS 是一个面向企业与团队的多智能体管理平台，提供从模型接入、Agent 配置、工具编排、对话调用到运行监控的完整闭环能力。

## 项目亮点

- 多 Agent 管理：支持 Agent 创建、配置、启停与分类管理。
- 多模型统一接入：可扩展接入 Qwen、OpenAI、Anthropic、DeepSeek、Kimi、GLM 等模型服务。
- 工具与 MCP 协作：内置工具、HTTP 工具与 MCP 服务统一编排，增强 Agent 执行能力。
- Agent API 能力：自动生成调用示例，支持 API Key 管理与第三方嵌入。
- 监控与运营视角：提供调用次数、成功率、响应耗时、Token 消耗等关键指标。

## 核心功能

### 1) AI 对话

- 支持与已配置 Agent 进行多轮对话。
- 适配流式响应，面向业务场景提供可控的对话体验。

### 2) Agent 管理

- 可视化管理 Agent 基本信息、提示词、模型参数与状态开关。
- 支持不同 Agent 类型，覆盖客服、文档分析、创作、数据分析等场景。

### 3) 工具 & MCP

- 内置网络搜索、HTTP 请求、代码执行、文件读写等工具能力。
- 可对接 MCP 服务扩展外部系统能力，构建更强的任务执行链路。

### 4) 模型管理

- 支持多模型供应商统一配置与启用控制。
- 可以按业务需求选择推理模型，平衡效果、速度与成本。

### 5) Agent 市场

- 提供模板化 Agent 能力，一键安装，降低搭建门槛。
- 支持按类别筛选，快速复用已有能力。

### 6) 监控日志与仪表盘

- 监控每次调用状态、耗时、Token 消耗与时间分布。
- 通过可视化图表快速识别性能与稳定性问题。

## 技术架构

### 前端

- Vue 3 + TypeScript + Vite
- Element Plus + ECharts
- Pinia + Vue Router

### 后端

- Spring Boot 3（Java 17）
- Maven 多模块架构：`mams-auth`、`mams-llm`、`mams-rag`、`mams-agent`、`mams-workflow`、`mams-monitor`、`mams-app`
- 生态组件：Sa-Token、MyBatis-Plus、LangChain4j、Redis、MinIO、PostgreSQL(pgvector)

## 项目结构

```text
mams/
├── mams-frontend/      # 前端工程（Vue3）
├── mams-backend/       # 后端工程（Spring Boot 多模块）
└── docs/images/        # README 展示截图
```

## 快速开始

### 方式一：本地开发

1. 启动后端（默认 `8080`）：
   - 进入 `mams-backend`
   - 执行 `mvn clean package -DskipTests`
   - 运行 `mams-app` 模块
2. 启动前端（默认 `3000`）：
   - 进入 `mams-frontend`
   - 执行 `npm install`
   - 执行 `npm run dev`
3. 浏览器访问 `http://localhost:3000`

> 前端开发代理已配置：`/api -> http://localhost:8080`，`/ws -> ws://localhost:8080`。

### 方式二：Docker 部署

- 参考 `mams-backend/deploy/docker/DOCKER_DEPLOY.md`
- 使用 `docker compose` 一键拉起 MySQL、PostgreSQL、Redis、MinIO、Backend、Frontend 全套服务

## 界面预览

### 总览首页

![Dashboard](docs/images/09-dashboard.png)

### AI 对话

![AI Chat](docs/images/01-ai-chat.png)

### Agent 管理

![Agent List](docs/images/02-agent-list.png)
![Agent Config](docs/images/03-agent-config.png)
![Agent API](docs/images/04-agent-api.png)

### 工具与模型

![Tools and MCP](docs/images/05-tools-mcp.png)
![Models](docs/images/06-models.png)

### Agent 市场与监控

![Agent Market](docs/images/07-agent-market.png)
![Monitoring](docs/images/08-monitoring.png)

## 开源路线建议（Roadmap）

- [ ] 工作流编排可视化（条件分支、并行节点、重试策略）
- [ ] 更完善的权限体系（组织、项目、角色、资源级权限）
- [ ] Prompt/工具版本管理与灰度发布
- [ ] 可观测性增强（链路追踪、告警中心、审计日志）
- [ ] 插件生态与第三方平台集成（IM、CRM、知识库）

## 贡献指南

欢迎通过 Issue / Pull Request 参与共建：

1. Fork 本仓库并创建特性分支
2. 提交清晰的变更说明与测试结果
3. 发起 PR 并等待 Review

## License

建议补充项目许可证（例如 MIT / Apache-2.0），便于社区协作与商用边界明确。