使用说明

MCP经理

一个全面的全栈应用程序，用于管理Claude Desktop的模型上下文协议（MCP）服务器，具有智能设置、自动扫描、增强的错误处理和现代web界面。

✨ 特性

🖥️ 全栈架构

CLI工具：具有安装向导和自动扫描功能的增强命令行界面
web界面：具有实时服务器管理功能的现代React前端
REST API：具有全面端点的FastAPI后端
交叉平台的：适用于Windows、macOS和Linux

🚀 核心功能

服务器发现：自动从多个来源查找可用的MCP服务器
简易安装：安装具有自动依赖关系管理的服务器
配置管理：使用原子操作安全管理Claude Desktop配置
备份和恢复：内置备份和恢复功能
实时监控：实时服务器状态和运行状况监控
Web仪表板：适用于所有操作的漂亮、响应迅速的web界面

🔧 增强功能

🧙‍♂️ 安装向导：为新用户提供交互式引导入职培训
🔍 自动扫描：自动发现新的MCP服务器和更新
🛠️ 智能错误处理：自动修复建议和智能恢复
📢 通知系统：随时了解更新和建议
💊 健康监测：系统诊断和依赖性检查
🎯 个性化推荐：智能服务器建议
⭐ GitHub集成：支持出色的mcp服务器存储库

🏗️ 建筑

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Web Frontend  │    │   REST API      │    │   CLI Tool      │
│   (React)       │────│   (FastAPI)     │────│   (Python)      │
│   Port 3001     │    │   Port 8001     │    │   Direct Access │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         └───────────────────────┼───────────────────────┘
                                 │
                    ┌─────────────────┐
                    │  Core Services  │
                    │                 │
                    │ • Config Mgmt   │
                    │ • Server Sources│
                    │ • Notifications │
                    │ • Health Monitor│
                    │ • GitHub Parser │
                    │ • Error Handler │
                    └─────────────────┘

🚀 快速开始

选项1：Web界面（推荐）

启动后端API：

cd backend
python -m venv venv
source venv/bin/activate  # On 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工具

# Clone and set up
git clone <your-repo-url>
cd mcp-manager
chmod +x mcp-manager

# Run interactive setup (recommended for first-time users)
./mcp-manager setup

📱 Web界面功能

🎛️ Dashboard

服务器安装状态概述
系统健康监测
快速访问常见操作
实时连接状态

🔧 服务器管理

浏览60多个可用的MCP服务器
一键安装/卸载服务器
查看详细的服务器信息
基于类别和标签的过滤

📊 系统监控

健康评分和系统诊断
依赖状态检查
配置验证
性能指标

⚙️ 配置

Visual Claude桌面配置管理
备份和恢复操作
环境设置
API配置

📢 通知

实时警报和更新
基于优先级的通知系统
一键解决方案的行动项
通知历史和管理

📋 CLI命令

核心命令

# Server Management
./mcp-manager list                    # Show installed servers
./mcp-manager available              # Show available servers
./mcp-manager backup                 # Create configuration backup

# Enhanced Commands
./mcp-manager setup                  # 🆕 Interactive setup wizard
./mcp-manager scan                   # 🆕 Scan for updates and new servers
./mcp-manager diagnose               # 🆕 Run system health check
./mcp-manager notifications          # 🆕 View alerts and updates
./mcp-manager status                 # Enhanced with notifications

命令选项

--config-path <path>     # Override default config location
--verbose                # Detailed output
--json                   # Output in JSON format
--no-cache              # Skip cache for fresh data
--force                 # Skip confirmation prompts

🛠️ 开发设置

先决条件

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设置：

# Make CLI executable
chmod +x mcp-manager

# Run setup wizard
./mcp-manager setup

可用脚本

后端

uvicorn app.main:app --reload          # Development server
uvicorn app.main:app --host 0.0.0.0    # Production server
python -m pytest                       # Run tests

前端

npm run dev         # Development server
npm run build       # Production build
npm run preview     # Preview production build
npm run lint        # Lint code

🌐 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管理器会自动发现您的Claude Desktop配置：

视窗: %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不可用”	从以下位置安装Node.jshttps://nodejs.org/
“pip不可用”	从安装Pythonhttps://python.org/
“权限被拒绝”	检查文件权限或以适当的权限运行

获取帮助

# CLI Diagnostics
./mcp-manager diagnose
./mcp-manager status --verbose
./mcp-manager notifications --all

# Web Interface
# Visit http://localhost:3001/system for health dashboard
# Check browser console for frontend errors
# Review backend logs for API issues

紧急恢复

如果您的配置损坏：

# List available backups
ls ~/.config/Claude/mcp_manager_backups/

# CLI recovery
./mcp-manager status --verbose

# Web interface recovery
# Navigate to System > Configuration for backup restore

🏢 技术栈

前端

反应18 使用TypeScript
快为了快速发展和建设
尾风CSS 适合现代风格
Tanstack查询 用于API状态管理
React路由器 用于导航

后端

快速 API 用于现代Python API开发
派丹蒂克 用于数据验证
乌维科恩 ASGI 服务器
请求： 用于HTTP客户端功能

CLI工具

Python 3.8+ 具有跨平台支持
富有的 用于美观的终端输出
点击用于CLI框架
GitPython 用于存储库操作

🤝 贡献

分叉存储库
创建要素分支(git checkout -b feature/amazing-feature)
进行更改
添加新功能的测试
确保所有测试通过
提交更改(git commit -m 'Add amazing feature')
推送到分支(git push origin feature/amazing-feature)
打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅许可证文件以获取详细信息。

⭐ 关键利益

零学习曲线：安装向导消除了配置复杂性
现代界面：漂亮的web UI和强大的CLI
与时俱进：永远不要错过重要更新或有用的新服务器
减少错误：自动错误检测和智能恢复
节省时间：智能推荐和一键式解决方案
生产就绪：全面的安全功能和错误处理
交叉平台的：在Windows、Mac和Linux上无缝工作

准备好开始了吗？

web界面：运行后端和前端，然后访问http://localhost:3001
CLI工具：运行 ./mcp-manager setup 获得有指导的设置体验！