mcps-one

<div align="center"> <img src="frontend\src\assets\logo.png" align="center" alt="MCPS.ONE" width="200" height="200"> <br>        让 MCP 工具管理变得简单高效的可视化统一平台 </div> ## 🎯 功能介绍 MCPS.ONE 是一个 MCP 工具管理平台，解决 MCP 工具分散管理、配置复杂、监控困难等问题： - **🔧 工具管理**: 统一管理各种 MCP 工具的配置、启停和监控 - **🌐 可视化界面**: 提供直观的 Web 管理界面 - **🔗 统一代理**: 提供统一的 HTTP 代理和 MCP 服务接入 - **⚡ 高性能**: 基于现代化技术栈构建 - **🛡️ 稳定可靠**: 具备自动重启和健康检查机制 ## 🚀 安装部署 ### 环境要求 - **Python**: 3.11+ - **Node.js**: 18+ - **操作系统**: Windows 10+, macOS 10.15+, Linux ### 快速启动 ```bash # 1. 克隆项目 git clone https://github.com/bulomi/mcps-one.git cd mcps-one # 2. 一键启动 # Windows start.bat # Linux/macOS ./start.sh # 3. 访问应用 # 前端界面: http://localhost:5173 # 后端API: http://localhost:8000 # API文档: http://localhost:8000/docs ``` ### Docker 部署 ```bash # 启动开发环境 docker-compose up -d # 查看服务状态 docker-compose ps # 查看日志 docker-compose logs -f # 停止服务 docker-compose down ``` 详细的 Docker 部署指南请参考 [DOCKER.md](DOCKER.md) ## ⚙️ 配置说明 ### 系统配置 系统配置文件位于以下位置： - **后端配置**: `backend/config/app.yaml` - **环境变量**: `backend/.env` - **前端配置**: `frontend/vite.config.ts` ### MCP客户端配置 ## 🖥️ Windows平台配置 ### 基本配置 ```json { "mcpServers": { "mcps-one": { "command": "/path/to/your/project/mcps-one/backend/.venv/Scripts/python.exe", "args": ["/path/to/your/project/mcps-one/backend/start_dynamic_mcp.py"], "env": { "PYTHONPATH": "/path/to/your/project/mcps-one/backend", "PYTHONIOENCODING": "utf-8", "MCP_SERVER_MODE": "server" } } } } ``` ## 🍎 macOS平台配置 ### 基本配置 ```json { "mcpServers": { "mcps-one": { "command": "~/path/to/mcps-one/backend/.venv/bin/python", "args": ["~/path/to/mcps-one/backend/start_dynamic_mcp.py"], "env": { "PYTHONPATH": "~/path/to/mcps-one/backend", "PYTHONIOENCODING": "utf-8", "MCP_SERVER_MODE": "server" } } } } ``` ## 🔧 配置参数说明 | 参数 | 说明 | 必需 | |------|------|------| | `command` | Python解释器路径 | ✅ | | `args` | MCP服务器启动脚本路径 | ✅ | | `PYTHONPATH` | Python模块搜索路径 | ✅ | | `PYTHONIOENCODING` | Python I/O编码设置 | ✅ | | `MCP_SERVER_MODE` | MCP服务器运行模式，`server`（默认）、`proxy` | 可选 | ## 效果演示 <img width="1583" height="658" alt="image" src="https://github.com/user-attachments/assets/e5eb31de-0ffb-4145-a18a-4aa3e2bac58a" /> <img width="792" height="736" alt="image" src="https://github.com/user-attachments/assets/d417693f-0db9-4009-9bf8-dffe44991069" /> <img width="789" height="580" alt="image" src="https://github.com/user-attachments/assets/c29fde42-ac20-461d-80d7-4ad2dcb42826" /> <img width="634" height="200" alt="image" src="https://github.com/user-attachments/assets/e10d8906-3770-49cc-9b47-0322a70e4c81" /> <img width="557" height="677" alt="image" src="https://github.com/user-attachments/assets/4f7d87b3-e245-41b0-9d3c-0f7b02f40444" /> <img width="559" height="680" alt="image" src="https://github.com/user-attachments/assets/f4a4abd3-6afe-44d8-8262-8f8323d6347e" /> ## 📚 相关文档 - **API 文档**: http://localhost:8000/docs - **Docker 部署**: [DOCKER.md](DOCKER.md) - **配置指南**: [docs/configuration.md](docs/configuration.md) - **快速入门**: [docs/getting-started.md](docs/getting-started.md) - **API 指南**: [docs/api-guide.md](docs/api-guide.md) - **后端说明**: [backend/README.md](backend/README.md) - **前端 API**: [frontend/src/api/README.md](frontend/src/api/README.md) ## 🙏 感谢名单 感谢以下开源项目和社区的支持： - [FastAPI](https://fastapi.tiangolo.com/) - 现代化的 Python Web 框架 - [Vue.js](https://vuejs.org/) - 渐进式 JavaScript 框架 - [Naive UI](https://www.naiveui.com/) - Vue 3 组件库 - [MCP](https://modelcontextprotocol.io/) - Model Context Protocol 规范 - [FastMCP](https://github.com/jlowin/fastmcp) - 快速构建 MCP 服务器的 Python 库 ## 🤝 贡献 欢迎提交 Issue 和 Pull Request！ ## 📄 许可证 本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情。 --- <div align="center"> **⭐ 如果这个项目对您有帮助，请给我们一个 Star！** 项目地址: [https://github.com/bulomi/mcps-one](https://github.com/bulomi/mcps-one) </div>