MiniCoze

MiniCoze 是一个可配置的 AI Agent 编排平台，提供模型、提示词、MCP 工具、工作流、会话、知识库和管理后台，支持构建聊天型与任务型智能体。

主要能力

• Agent、模型、Prompt、Advisor 和 MCP 配置管理
• Chat、ReAct、Step、Loop 等执行模式
• SSE 流式对话与长任务执行
• 文件和 Git 仓库 RAG 接入
• 工作流画布、模板与广场
• 会话、用户、工作区和后台管理
• 高德、博查、CSDN、邮件、企业微信 MCP Server

技术栈

• 后端：Java 17、Spring Boot 3.4、Spring AI、MyBatis
• 前端：Vue 3、Pinia、Vue Router、Vue Flow、ECharts、Vite
• 数据：MySQL、PostgreSQL / pgvector、Redis
• 基础设施：RabbitMQ、One API、Docker Compose

目录结构

MiniCoze/
├─ backend/          # 多模块 Agent 后端
├─ frontend/         # Vue 管理端和用户端
└─ mcp/              # 独立 MCP Server 集合

本地启动

1. 启动依赖

docker compose -f backend/docs/docker/docker-compose.yml up -d

初始化脚本位于 backend/docs/docker/conf/table.sql。

2. 配置环境变量

后端 dev Profile 从环境变量读取敏感配置，常用变量包括：

export OPENAI_BASE_URL="https://your-compatible-endpoint/v1"
export OPENAI_API_KEY="your-key"
export SYSTEM_MODEL_BASE_URL="https://your-compatible-endpoint/v1"
export SYSTEM_MODEL_API_KEY="your-key"
export SYSTEM_MODEL_NAME="your-model"
export MYSQL_USERNAME="root"
export MYSQL_PASSWORD="your-password"
export MYSQL_DB_NAME="ai_agent"
export POSTGRESQL_USERNAME="postgres"
export POSTGRESQL_PASSWORD="your-password"
export POSTGRESQL_DB_NAME="ai_agent"
export REDIS_PASSWORD="your-password"
export JWT_SECRET="replace-with-a-random-secret"

完整变量清单请查看 backend/ai-agent-app/src/main/resources/application-dev.yml。

3. 启动后端

cd backend
mvn -pl ai-agent-app -am spring-boot:run

4. 启动前端

cd frontend
npm install
npm run dev

5. 可选：启动 MCP Server

每个 mcp/mcp-server-* 目录都是独立的 Spring Boot 项目。只启动当前 Agent 需要的工具，并为其配置对应的第三方凭据。

常用检查

cd backend && mvn test
cd frontend && npm run test && npm run build

安全说明

不要提交模型密钥、JWT Secret、邮箱授权码或第三方平台凭据。示例共享密钥仅用于本地开发，公开部署前必须替换。