内容
<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>
MCP 市场