MCP Agents Cloud是一个提供管理MCP服务器和代理（Agent）的平台。

功能特性

用户管理（注册、登录、密码重置）
MCP服务器管理（添加、编辑、删除、查看）
Agent管理（创建、编辑、删除、查看）
Agent SDK（Python包和HTTP API）
Agent聊天交互（流式输出）
SDK密钥管理

技术栈

前端

Vue.js
Element UI
Axios
Vue Router
Vuex

后端

Python
FastAPI
SQLAlchemy
JWT
openai-agent框架

数据库

MySQL 8.0

快速开始

安装依赖组件

项目依赖MySQL数据库，可以通过Docker快速安装：

# 进入docker目录
cd docker

# 确保数据目录存在
sudo mkdir -p /appdata/share/agents-mcp-cloud/mysql/data
sudo chown -R $USER:$USER /appdata/share/agents-mcp-cloud/mysql/data

# 启动MySQL服务
docker-compose up -d mysql

数据库将在63307端口启动。详细说明请参考Docker依赖组件文档。

后端设置

cd backend

创建虚拟环境：

python -m venv venv

激活虚拟环境：

# Windows
venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

安装依赖：

pip install -r requirements.txt

配置系统：

# 根据环境选择复制对应的配置文件
cp config.yml.example config-dev.yml
# 然后编辑配置文件

运行应用：

# 设置环境（默认为dev）
export ENV=dev  # 或 test, prod

# 或直接指定配置文件的绝对路径
export CONFIG_FILE="$(pwd)/config-dev.yml"

# 运行服务
cd backend  # 确保在backend目录下运行
uvicorn main:app --reload

前端设置

cd frontend

安装依赖：

npm install

运行开发服务器：

npm run serve

构建生产版本：

npm run build

配置说明

项目使用基于环境的YAML配置文件：

config-dev.yml：开发环境配置
config-test.yml：测试环境配置
config-prod.yml：生产环境配置

配置文件应放在backend目录下，可以通过以下两种方式指定配置：

# 1. 通过环境变量指定环境，系统将查找backend/config-{ENV}.yml
export ENV=dev  # 或 test, prod

# 2. 直接指定配置文件的绝对路径（推荐）
export CONFIG_FILE="/完整路径/到配置文件/config-dev.yml"

主要配置项包括：

app: 应用名称、版本等基本信息
api: API路径前缀和文档URL
server: 服务器主机、端口设置
security: 安全设置（密钥、令牌过期时间）
cors: 跨域设置
database: 数据库连接URL和连接池设置
openai: OpenAI API密钥和模型设置
email: 电子邮件发送设置
smtp: SMTP服务器配置

详细配置示例请参考config.yml.example文件。

API文档

启动后端服务器后，可以在以下地址访问API文档：

http://localhost:8000/docs

项目结构

agents-mcp-cloud/
├── backend/             # 后端代码
│   ├── app/             # 应用代码
│   │   ├── api/         # API路由
│   │   ├── core/        # 核心功能
│   │   ├── db/          # 数据库工具
│   │   ├── models/      # 数据模型
│   │   ├── schemas/     # Pydantic模式
│   │   ├── utils/       # 工具函数
│   │   └── services/    # 业务服务
│   ├── config-dev.yml   # 开发环境配置 
│   ├── config-test.yml  # 测试环境配置
│   ├── config-prod.yml  # 生产环境配置
│   ├── main.py          # 主应用入口
│   └── requirements.txt # 依赖列表
├── docker/              # Docker依赖组件
│   ├── docker-compose.yml # Docker编排文件
│   └── mysql/           # MySQL相关配置
├── frontend/            # 前端代码
│   ├── public/          # 静态资源
│   ├── src/             # 源代码
│   │   ├── assets/      # 资源文件
│   │   ├── components/  # Vue组件
│   │   ├── router/      # 路由配置
│   │   ├── store/       # Vuex存储
│   │   ├── views/       # 页面视图
│   │   └── api/         # API客户端
│   └── package.json     # 依赖列表
└── scripts/             # 脚本文件

许可证

MIT

MCP Agents Cloud

About