What is Agents Mcp Cloud

agents-mcp-cloud is a platform designed for managing MCP servers and agents (Agents), providing a comprehensive solution for user management, server management, and agent interaction.

Use cases

Use cases for agents-mcp-cloud include managing multiple agents for customer support, automating tasks through agent interactions, and developing applications that require real-time data processing and user management.

How to use

To use agents-mcp-cloud, set up the MySQL database using Docker, configure the backend and frontend environments, and run the application. Detailed instructions are provided in the README file.

Key features

Key features include user management (registration, login, password reset), MCP server management (add, edit, delete, view), agent management (create, edit, delete, view), Agent SDK (Python package and HTTP API), agent chat interaction (streaming output), and SDK key management.

Where to use

agents-mcp-cloud can be used in various fields such as software development, cloud services, and any application requiring agent-based interactions and server management.

MCP Agents Cloud

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依赖组件文档。

后端设置

1. 进入后端目录：

cd backend

2. 创建虚拟环境：

python -m venv venv

3. 激活虚拟环境：

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

4. 安装依赖：

pip install -r requirements.txt

5. 配置系统：

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

6. 运行应用：

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

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

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

前端设置

1. 进入前端目录：

cd frontend

2. 安装依赖：

npm install

3. 运行开发服务器：

npm run serve

4. 构建生产版本：

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