MCP Agents Cloud

MCP Agents Cloud

MCP Agents CloudはMCPサーバーとエージェント（Agent）の管理を提供するプラットフォームです。

機能特性

• ユーザー管理（登録、ログイン、パスワードリセット）
• MCPサーバー管理（追加、編集、削除、表示）
• エージェント管理（作成、編集、削除、表示）
• エージェント SDK（Pythonパッケージと HTTP API）
• エージェントチャット対話（ストリーミング出力）
• 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ディレクトリに配置し、以下の2つの方法で設定を指定できます：

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

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

主な設定項目：

• app: アプリケーション名、バージョンなどの基本情報
• api: APIパスプレフィックスとドキュメントURL
• server: サーバーホスト、ポート設定
• security: セキュリティ設定（キー、トークン有効期限）
• cors: 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