Toolbox - MCP Server Manager

Toolbox - MCP 服务管理器

一个用于管理 MCP 服务并生成配置文件的 Web 应用。

功能

• 仓库管理（添加、查看、删除）
• 使用 GPT 自动提取 README 文件中的信息
• 生成 YAML 和 JSON 配置
• 使用 React 和 Tailwind CSS 打造的现代化界面
• 用于仓库管理和配置生成的命令行工具
• 基于向量的仓库搜索

项目结构

项目分为两个主要部分：

• 后端：用于提供 API 端点的 FastAPI 服务
• 前端：使用 Tailwind CSS 的 React 应用

前置条件

• Python 3.8+
• Node.js 18+
• Git
• OpenAI API 密钥
• Qdrant 向量数据库（用于仓库存储和搜索）

开始使用

后端设置

1. 进入后端目录：

cd backend

2. 创建虚拟环境：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

3. 安装依赖：

pip install -r requirements.txt

4. 运行 FastAPI 服务：

python run.py

API 将在 http://localhost:8020 提供服务。

前端设置

1. 进入前端目录：

cd frontend

2. 安装依赖：

npm install

3. 启动开发服务器：

npm run dev

Web 应用将在 http://localhost:5173 提供服务。

API 文档

后端运行后，可通过以下地址访问 API 文档：

• Swagger UI：http://localhost:8020/docs
• ReDoc：http://localhost:8020/redoc

命令行工具

应用包含两个命令行工具：

添加服务工具

此工具可将 Git 仓库添加到数据库：

python backend/add_server.py https://github.com/username/repo.git

可选参数：

• --name：为仓库指定自定义名称
• --description：为仓库指定自定义描述
• --command：为运行仓库指定自定义命令
• --args：为命令指定自定义参数

配置工具

此工具提供管理配置的功能：

python backend/cli.py generate-yaml

可用命令：

• generate-yaml：生成 YAML 配置文件
  • -o, --output：指定输出文件路径
  • -p, --print：将 YAML 输出到标准输出
• list：列出数据库中的所有仓库

开发说明

• OpenAI API 密钥硬编码在 backend/app/services/openai_service.py 中。在生产环境中，应将其替换为环境变量。
• 仓库数据存储在 Qdrant 向量数据库中。请确保正确配置 Qdrant 实例并定期备份。
• 可在应用的“向量设置”部分配置 Qdrant 连接参数。

许可证

MIT