使用说明
工具箱-MCP服务器管理器
用于管理MCP服务器和生成配置文件的web应用程序。
特性
- 存储库管理(添加、查看、删除)
- 使用GPT从README文件中自动提取信息
- YAML和JSON配置生成
- 使用React和Tailwind CSS的现代UI
- 用于存储库管理和配置生成的命令行工具
- 基于矢量的存储库搜索
项目结构
该项目分为两个主要部分:
- 后端:API终结点的FastAPI服务器
- 前端:使用Tailwind CSS的React应用程序
先决条件
- Python 3.8+
- Node.js 18+
- Git
- OpenAI API密钥
- Qdrant矢量数据库(用于存储库存储和搜索)
入门指南
后端设置
- 导航到后端目录:
cd backend
- 创建虚拟环境:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
- 安装依赖项:
pip install -r requirements.txt
- 运行FastAPI服务器:
python run.py
API将于http://localhost:8020.
前端设置
- 导航到前端目录:
cd frontend
- 安装依赖项:
npm install
- 启动开发服务器:
npm run dev
web应用程序将在http://localhost:5173.
API文档
后端运行后,您可以访问API文档,网址为:
- Swagger用户界面:http://localhost:8020/docs
- 重新记录: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打印到stdout
list:列出数据库中的所有存储库
开发说明
- OpenAI API密钥是硬编码的
backend/app/services/openai_service.py在生产环境中,应将其替换为环境变量。 - 存储库数据存储在Qdrant矢量数据库中。确保您的Qdrant实例已正确配置并定期备份。
- Qdrant连接参数可以在应用程序的矢量设置部分配置。
许可证
麻省理工学院
