项目介绍
MCP Manager
一个全面的全栈应用程序，用于管理Claude Desktop的模型上下文协议（MCP）服务器，具有智能设置、自动扫描、增强的错误处理和现代的Web界面。
✨ 特性
🖥️ 全栈架构
- CLI 工具：增强的命令行界面，带有设置向导和自动扫描
- Web 界面：现代的React前端，实时服务器管理
- REST API：FastAPI后端，提供全面的端点
- 跨平台：支持Windows、macOS和Linux
🚀 核心功能
- 服务器发现：从多个来源自动查找可用的MCP服务器
- 简单安装：自动依赖管理的服务器安装
- 配置管理：通过原子操作安全地管理Claude Desktop配置
- 备份与恢复：内置的备份和恢复功能
- 实时监控：实时服务器状态和健康监控
- Web仪表板：用于所有操作的美观且响应式的Web界面
🔧 增强功能
- 🧙♂️ 设置向导：为新用户提供的交互式引导
- 🔍 自动扫描：自动发现新的MCP服务器和更新
- 🛠️ 智能错误处理：自动修复建议和智能恢复
- 📢 通知系统：关于更新和建议的通知
- 💊 健康监控：系统诊断和依赖检查
- 🎯 个性化推荐：智能的服务器建议
- ⭐ GitHub集成：支持awesome-mcp-servers仓库
🏗️ 架构
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Web前端 │ │ REST API │ │ CLI工具 │
│ (React) │────│ (FastAPI) │────│ (Python) │
│ 端口3001 │ │ 端口8001 │ │ 直接访问 │
└─────────────────┘ └─────────────────┘ └─────────────────┘
│ │ │
└───────────────────────┼───────────────────────┘
│
┌─────────────────┐
│ 核心服务 │
│ │
│ • 配置管理 │
│ • 服务器来源 │
│ • 通知 │
│ • 健康监控 │
│ • GitHub解析器 │
│ • 错误处理器 │
└─────────────────┘
🚀 快速开始
选项1：Web界面（推荐）
-
启动后端API：
cd backend python -m venv venv source venv/bin/activate # 在Windows上：venv\Scripts\activate pip install -r requirements.txt uvicorn app.main:app --host 0.0.0.0 --port 8001 --reload -
启动前端：
cd frontend npm install npm run dev -
访问Web界面： 在浏览器中打开http://localhost:3001
选项2：CLI工具
# 克隆并设置
git clone <your-repo-url>
cd mcp-manager
chmod +x mcp-manager
# 运行交互式设置（推荐首次使用）
./mcp-manager setup
📱 Web界面特性
🎛️ 仪表板
- 服务器安装状态概览
- 系统健康监控
- 常用操作的快速访问
- 实时连接状态
🔧 服务器管理
- 浏览60多种可用的MCP服务器
- 单击安装或卸载服务器
- 查看详细的服务器信息
- 基于类别和标签的过滤
📊 系统监控
- 健康评分和系统诊断
- 依赖状态检查
- 配置验证
- 性能指标
⚙️ 配置
- 可视化Claude Desktop配置管理
- 备份和恢复操作
- 环境设置
- API配置
📢 通知
- 实时警报和更新
- 基于优先级的通知系统
- 单击解决方案的操作项
- 通知历史和管理
📋 CLI命令
核心命令
# 服务器管理
./mcp-manager list # 显示已安装的服务器
./mcp-manager available # 显示可用的服务器
./mcp-manager backup # 创建配置备份
# 增强命令
./mcp-manager setup # 🆕 交互式设置向导
./mcp-manager scan # 🆕 扫描更新和新服务器
./mcp-manager diagnose # 🆕 运行系统健康检查
./mcp-manager notifications # 🆕 查看警报和更新
./mcp-manager status # 增强的通知功能
命令选项
--config-path <path> # 覆盖默认配置位置
--verbose # 详细输出
--json # JSON格式输出
--no-cache # 跳过缓存以获取新鲜数据
--force # 跳过确认提示
🛠️ 开发环境设置
前提条件
- Python 3.8+ （必需）
- Node.js 16+ 和 npm （用于前端）
- Git （用于版本控制）
完整的开发环境
-
克隆仓库：
git clone <your-repo-url> cd mcp-manager -
后端设置：
cd backend python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt uvicorn app.main:app --host 0.0.0.0 --port 8001 --reload -
前端设置：
cd frontend npm install npm run dev -
CLI设置：
# 使CLI可执行 chmod +x mcp-manager # 运行设置向导 ./mcp-manager setup
可用脚本
后端
uvicorn app.main:app --reload # 开发服务器
uvicorn app.main:app --host 0.0.0.0 # 生产服务器
python -m pytest # 运行测试
前端
npm run dev # 开发服务器
npm run build # 生产构建
npm run preview # 预览生产构建
npm run lint # 代码检查
🌐 API端点
FastAPI后端提供了全面的REST端点：
GET /api/health：健康检查GET /api/servers/available：列出可用的服务器GET /api/servers/installed：列出已安装的服务器POST /api/servers/install：安装服务器DELETE /api/servers/{name}：卸载服务器GET /api/system/status：系统健康状态POST /api/system/scan：运行系统扫描GET /api/notifications/：获取通知GET /api/analytics/overview：分析仪表板
完整的API文档可在：http://localhost:8001/docs
🔧 配置
MCP Manager会自动发现您的Claude Desktop配置：
- Windows：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json - Linux：
~/.config/Claude/claude_desktop_config.json
配置模式
{
"mcpServers": {
"server-name": {
"command": "executable-path",
"args": ["arg1", "arg2"],
"env": {
"KEY": "value"
}
}
}
}
🛡️ 安全特性
原子操作
- 所有配置更改都使用原子文件操作
- 临时文件防止写入期间的损坏
- 任何失败都会自动回滚
自动备份
- 在任何破坏性操作之前创建备份
- 时间戳备份文件便于识别
- 通过Web界面或CLI轻松恢复
全面验证
- 对所有配置更改进行JSON模式验证
- 服务器名称验证（字母数字，带连字符/下划线）
- 环境变量验证
- 操作前的预飞行检查
🚨 故障排除
常见问题
| 问题 | 解决方案 |
|---|---|
| "未找到配置" | 运行设置向导或确保Claude Desktop至少运行一次 |
| "后端连接失败" | 确保后端在8001端口运行 |
| "npm不可用" | 从https://nodejs.org/安装Node.js |
| "pip不可用" | 从https://python.org/安装Python |
| "权限被拒绝" | 检查文件权限或以适当的权限运行 |
获取帮助
# CLI诊断
./mcp-manager diagnose
./mcp-manager status --verbose
./mcp-manager notifications --all
# Web界面
# 访问http://localhost:3001/system查看健康仪表盘
# 检查浏览器控制台中的前端错误
# 查看后端日志以解决API问题
紧急恢复
如果您的配置变得损坏：
# 列出可用的备份
ls ~/.config/Claude/mcp_manager_backups/
# CLI恢复
./mcp-manager status --verbose
# Web界面恢复
# 导航到系统 > 配置以恢复备份
🏢 技术堆栈
前端
- React 18 与 TypeScript
- Vite 用于快速开发和构建
- TailwindCSS 用于现代样式
- Tanstack Query 用于API状态管理
- React Router 用于导航
后端
- FastAPI 用于现代Python API开发
- Pydantic 用于数据验证
- Uvicorn 作为ASGI服务器
- Requests 用于HTTP客户端功能
CLI工具
- Python 3.8+ 支持跨平台
- Rich 用于漂亮的终端输出
- Click 作为CLI框架
- GitPython 用于仓库操作
🤝 贡献
- 分叉仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 进行更改
- 为新功能添加测试
- 确保所有测试通过
- 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 打开Pull Request
📄 许可证
此项目采用MIT许可证 - 详情见LICENSE文件。
⭐ 关键优势
- 零学习曲线：设置向导消除了配置复杂性
- 现代界面：美观的Web UI和强大的CLI
- 保持最新：永远不会错过重要的更新或有用的服务器
- 减少错误：自动错误检测和智能恢复
- 节省时间：智能推荐和一键解决方案
- 生产就绪：全面的安全特性和错误处理
- 跨平台：无缝支持Windows、Mac和Linux
准备好开始了吗？
- Web界面：运行后端和前端，然后访问http://localhost:3001
- CLI工具：运行
./mcp-manager setup以获得引导式设置体验！