MCP Manager

Una aplicación full-stack para gestionar servidores del Protocolo de Contexto de Modelo (MCP) para Claude Desktop con una interfaz web moderna.

GitHub

Prueba este MCPPatrocinado

Documentación

MCP Manager

Una aplicación full-stack integral para gestionar servidores de Model Context Protocol (MCP) para Claude Desktop con configuración inteligente, autoescaneo, manejo mejorado de errores y una interfaz web moderna.

✨ Características

🖥️ Arquitectura Full-Stack

Herramienta CLI: Interfaz de línea de comandos mejorada con asistente de configuración y autoescaneo
Interfaz Web: Frontend moderno de React con gestión de servidores en tiempo real
API REST: Backend de FastAPI con endpoints completos
Multiplataforma: Funciona en Windows, macOS y Linux

🚀 Funcionalidad Principal

Descubrimiento de Servidores: Encuentra automáticamente servidores MCP disponibles de múltiples fuentes
Instalación Fácil: Instala servidores con gestión automática de dependencias
Gestión de Configuración: Gestiona de forma segura la configuración de Claude Desktop con operaciones atómicas
Copia de Seguridad y Restauración: Funcionalidad integrada de copia de seguridad y restauración
Monitoreo en Tiempo Real: Estado de servidores en vivo y monitoreo de salud
Panel Web: Interfaz web hermosa y receptiva para todas las operaciones

🔧 Características Mejoradas

🧙‍♂️ Asistente de Configuración: Incorporación interactiva guiada para nuevos usuarios
🔍 Autoescaneo: Descubrimiento automático de nuevos servidores MCP y actualizaciones
🛠️ Manejo Inteligente de Errores: Sugerencias de corrección automática y recuperación inteligente
📢 Sistema de Notificaciones: Mantente informado sobre actualizaciones y recomendaciones
💊 Monitoreo de Salud: Diagnósticos del sistema y verificación de dependencias
🎯 Recomendaciones Personalizadas: Sugerencias inteligentes de servidores
⭐ Integración con GitHub: Soporte para repositorios awesome-mcp-servers

🏗️ Arquitectura

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   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 │
                    └─────────────────┘

🚀 Inicio Rápido

Opción 1: Interfaz Web (Recomendada)

Inicia la API del Backend:

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

Inicia el Frontend:
```
cd frontend
npm install
npm run dev
```
Accede a la Interfaz Web: Abre http://localhost:3001 en tu navegador

Opción 2: Herramienta 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

📱 Características de la Interfaz Web

🎛️ Panel de Control

Resumen del estado de instalación de servidores
Monitoreo de salud del sistema
Acceso rápido a operaciones comunes
Estado de conexión en tiempo real

🔧 Gestión de Servidores

Explora más de 60 servidores MCP disponibles
Instala/desinstala servidores con un clic
Visualiza información detallada del servidor
Filtrado por categoría y etiquetas

📊 Monitoreo del Sistema

Puntuación de salud y diagnósticos del sistema
Verificación del estado de dependencias
Validación de configuración
Métricas de rendimiento

⚙️ Configuración

Gestión visual de la configuración de Claude Desktop
Operaciones de copia de seguridad y restauración
Ajustes de entorno
Configuración de API

📢 Notificaciones

Alertas y actualizaciones en tiempo real
Sistema de notificaciones basado en prioridades
Elementos de acción con soluciones de un clic
Historial y gestión de notificaciones

📋 Comandos CLI

Comandos Principales

# 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

Opciones de Comandos

--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

🛠️ Configuración de Desarrollo

Requisitos Previos

Python 3.8+ (requerido)
Node.js 16+ y npm (para el frontend)
Git (para control de versiones)

Entorno de Desarrollo Completo

Clona el Repositorio:

git clone <your-repo-url>
cd mcp-manager

Configuración del Backend:

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

Configuración del Frontend:
```
cd frontend
npm install
npm run dev
```

Configuración de CLI:

# Make CLI executable
chmod +x mcp-manager

# Run setup wizard
./mcp-manager setup

Scripts Disponibles

Backend

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

Frontend

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

🌐 Endpoints de la API

El backend de FastAPI proporciona endpoints REST completos:

GET /api/health: Verificación de salud
GET /api/servers/available: Listar servidores disponibles
GET /api/servers/installed: Listar servidores instalados
POST /api/servers/install: Instalar un servidor
DELETE /api/servers/{name}: Desinstalar un servidor
GET /api/system/status: Estado de salud del sistema
POST /api/system/scan: Ejecutar escaneo del sistema
GET /api/notifications/: Obtener notificaciones
GET /api/analytics/overview: Panel de análisis

Documentación completa de la API disponible en: http://localhost:8001/docs

🔧 Configuración

MCP Manager descubre automáticamente tu configuración de 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

Esquema de Configuración

{
  "mcpServers": {
    "server-name": {
      "command": "executable-path",
      "args": ["arg1", "arg2"],
      "env": {
        "KEY": "value"
      }
    }
  }
}

🛡️ Características de Seguridad

Operaciones Atómicas

Todos los cambios de configuración utilizan operaciones atómicas de archivos
Los archivos temporales previenen la corrupción durante las escrituras
Reversión automática ante cualquier fallo

Copias de Seguridad Automáticas

Se crean copias de seguridad antes de cualquier operación destructiva
Archivos de copia de seguridad con marca de tiempo para fácil identificación
Restauración sencilla a través de la interfaz web o CLI

Validación Integral

Validación de esquema JSON para todos los cambios de configuración
Validación de nombres de servidor (alfanuméricos con guiones/guiones bajos)
Validación de variables de entorno
Verificaciones previas antes de las operaciones

🚨 Solución de Problemas

Problemas Comunes

Problema	Solución
"No se encontró configuración"	Ejecuta el asistente de configuración o asegúrate de que Claude Desktop se haya ejecutado al menos una vez
"Falló la conexión con el backend"	Asegúrate de que el backend esté ejecutándose en el puerto 8001
"npm no disponible"	Instala Node.js desde https://nodejs.org/
"pip no disponible"	Instala Python desde https://python.org/
"Permiso denegado"	Verifica los permisos de archivo o ejecuta con los privilegios adecuados

Obtener Ayuda

# 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

Recuperación de Emergencia

Si tu configuración se corrompe:

# 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

🏢 Stack Tecnológico

Frontend

React 18 con TypeScript
Vite para desarrollo y compilación rápidos
TailwindCSS para estilos modernos
Tanstack Query para gestión de estado de API
React Router para navegación

Backend

FastAPI para desarrollo moderno de API en Python
Pydantic para validación de datos
Uvicorn para servidor ASGI
Requests para funcionalidad de cliente HTTP

Herramienta CLI

Python 3.8+ con soporte multiplataforma
Rich para salida de terminal hermosa
Click para framework CLI
GitPython para operaciones de repositorio

🤝 Contribuciones

Haz un fork del repositorio
Crea una rama de características (git checkout -b feature/amazing-feature)
Realiza tus cambios
Añade pruebas para la nueva funcionalidad
Asegúrate de que todas las pruebas pasen
Realiza los commits (git commit -m 'Add amazing feature')
Sube a la rama (git push origin feature/amazing-feature)
Abre una Pull Request

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.

⭐ Beneficios Clave

Curva de Aprendizaje Cero: El asistente de configuración elimina la complejidad de configuración
Interfaz Moderna: Interfaz web hermosa junto con potente CLI
Mantente Actualizado: Nunca te pierdas actualizaciones importantes o servidores nuevos útiles
Reduce Errores: Detección automática de errores y recuperación inteligente
Ahorra Tiempo: Recomendaciones inteligentes y soluciones de un clic
Listo para Producción: Características de seguridad integrales y manejo de errores
Multiplataforma: Funciona sin problemas en Windows, Mac y Linux

¿Listo para comenzar?

Interfaz Web: Ejecuta el backend y el frontend, luego visita http://localhost:3001
Herramienta CLI: Ejecuta ./mcp-manager setup para una experiencia de configuración guiada.