MCP Manager

Um aplicativo full-stack para gerenciar servidores Model Context Protocol (MCP) para o Claude Desktop com uma interface web moderna.

GitHub

Experimente este MCPPatrocinado

Documentação

MCP Manager

Um aplicativo full-stack abrangente para gerenciar servidores Model Context Protocol (MCP) para o Claude Desktop, com configuração inteligente, varredura automática, tratamento aprimorado de erros e uma interface web moderna.

✨ Recursos

🖥️ Arquitetura Full-Stack

Ferramenta CLI: Interface de linha de comando aprimorada com assistente de configuração e varredura automática
Interface Web: Frontend React moderno com gerenciamento de servidores em tempo real
API REST: Backend FastAPI com endpoints abrangentes
Multiplataforma: Funciona em Windows, macOS e Linux

🚀 Funcionalidade Principal

Descoberta de Servidores: Encontra automaticamente servidores MCP disponíveis em múltiplas fontes
Instalação Fácil: Instala servidores com gerenciamento automático de dependências
Gerenciamento de Configuração: Gerencia com segurança a configuração do Claude Desktop com operações atômicas
Backup e Restauração: Funcionalidade integrada de backup e restauração
Monitoramento em Tempo Real: Status de servidores e monitoramento de saúde ao vivo
Painel Web: Interface web bonita e responsiva para todas as operações

🔧 Recursos Aprimorados

🧙‍♂️ Assistente de Configuração: Onboarding interativo guiado para novos usuários
🔍 Varredura Automática: Descoberta automática de novos servidores MCP e atualizações
🛠️ Tratamento Inteligente de Erros: Sugestões de correção automática e recuperação inteligente
📢 Sistema de Notificações: Mantenha-se informado sobre atualizações e recomendações
💊 Monitoramento de Saúde: Diagnóstico do sistema e verificação de dependências
🎯 Recomendações Personalizadas: Sugestões inteligentes de servidores
⭐ Integração com GitHub: Suporte para repositórios awesome-mcp-servers

🏗️ Arquitetura

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

🚀 Início Rápido

Opção 1: Interface Web (Recomendado)

Inicie a API 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

Inicie o Frontend:
```
cd frontend
npm install
npm run dev
```
Acesse a Interface Web: Abra http://localhost:3001 no seu navegador

Opção 2: Ferramenta 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

📱 Recursos da Interface Web

🎛️ Painel

Visão geral do status de instalação dos servidores
Monitoramento de saúde do sistema
Acesso rápido a operações comuns
Status de conexão em tempo real

🔧 Gerenciamento de Servidores

Navegue por mais de 60 servidores MCP disponíveis
Instale/desinstale servidores com um clique
Visualize informações detalhadas dos servidores
Filtragem por categoria e tags

📊 Monitoramento do Sistema

Pontuação de saúde e diagnóstico do sistema
Verificação de status de dependências
Validação de configuração
Métricas de desempenho

⚙️ Configuração

Gerenciamento visual da configuração do Claude Desktop
Operações de backup e restauração
Configurações de ambiente
Configuração da API

📢 Notificações

Alertas e atualizações em tempo real
Sistema de notificação baseado em prioridade
Itens de ação com soluções de um clique
Histórico e gerenciamento de notificações

📋 Comandos CLI

Comandos Principais

# 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

Opções de Comando

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

🛠️ Configuração de Desenvolvimento

Pré-requisitos

Python 3.8+ (obrigatório)
Node.js 16+ e npm (para o frontend)
Git (para controle de versão)

Ambiente de Desenvolvimento Completo

Clone o Repositório:

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

Configuração do 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

Configuração do Frontend:
```
cd frontend
npm install
npm run dev
```

Configuração do CLI:

# Make CLI executable
chmod +x mcp-manager

# Run setup wizard
./mcp-manager setup

Scripts Disponíveis

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

O backend FastAPI fornece endpoints REST abrangentes:

GET /api/health: Verificação de saúde
GET /api/servers/available: Listar servidores disponíveis
GET /api/servers/installed: Listar servidores instalados
POST /api/servers/install: Instalar um servidor
DELETE /api/servers/{name}: Desinstalar um servidor
GET /api/system/status: Status de saúde do sistema
POST /api/system/scan: Executar varredura do sistema
GET /api/notifications/: Obter notificações
GET /api/analytics/overview: Painel de análises

Documentação completa da API disponível em: http://localhost:8001/docs

🔧 Configuração

O MCP Manager descobre automaticamente a configuração do seu 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 Configuração

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

🛡️ Recursos de Segurança

Operações Atômicas

Todas as alterações de configuração usam operações atômicas de arquivo
Arquivos temporários previnem corrupção durante gravações
Reversão automática em caso de qualquer falha

Backups Automáticos

Backups criados antes de qualquer operação destrutiva
Arquivos de backup com carimbo de data/hora para fácil identificação
Restauração fácil pela interface web ou CLI

Validação Abrangente

Validação de esquema JSON para todas as alterações de configuração
Validação de nomes de servidores (alfanuméricos com hífens/sublinhados)
Validação de variáveis de ambiente
Verificações pré-voo antes das operações

🚨 Solução de Problemas

Problemas Comuns

Problema	Solução
"Nenhuma configuração encontrada"	Execute o assistente de configuração ou garanta que o Claude Desktop foi executado pelo menos uma vez
"Falha na conexão com o backend"	Garanta que o backend esteja rodando na porta 8001
"npm não disponível"	Instale o Node.js a partir de https://nodejs.org/
"pip não disponível"	Instale o Python a partir de https://python.org/
"Permissão negada"	Verifique as permissões de arquivo ou execute com privilégios apropriados

Obtendo Ajuda

# 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

Recuperação de Emergência

Se a sua configuração for corrompida:

# 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

🏢 Pilha de Tecnologias

Frontend

React 18 com TypeScript
Vite para desenvolvimento e build rápidos
TailwindCSS para estilização moderna
Tanstack Query para gerenciamento de estado da API
React Router para navegação

Backend

FastAPI para desenvolvimento moderno de API em Python
Pydantic para validação de dados
Uvicorn para servidor ASGI
Requests para funcionalidade de cliente HTTP

Ferramenta CLI

Python 3.8+ com suporte multiplataforma
Rich para saída de terminal bonita
Click para framework CLI
GitPython para operações de repositório

🤝 Contribuindo

Faça um fork do repositório
Crie um branch de funcionalidade (git checkout -b feature/amazing-feature)
Faça suas alterações
Adicione testes para novas funcionalidades
Garanta que todos os testes passem
Faça commit das alterações (git commit -m 'Add amazing feature')
Envie para o branch (git push origin feature/amazing-feature)
Abra um Pull Request

📄 Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

⭐ Benefícios Principais

Zero Curva de Aprendizado: O assistente de configuração elimina a complexidade de configuração
Interface Moderna: Interface web bonita junto com CLI poderoso
Mantenha-se Atualizado: Nunca perca atualizações importantes ou novos servidores úteis
Reduza Erros: Detecção automática de erros e recuperação inteligente
Economize Tempo: Recomendações inteligentes e soluções de um clique
Pronto para Produção: Recursos abrangentes de segurança e tratamento de erros
Multiplataforma: Funciona perfeitamente em Windows, Mac e Linux

Pronto para começar?

Interface Web: Execute o backend e o frontend, depois visite http://localhost:3001
Ferramenta CLI: Execute ./mcp-manager setup para uma experiência de configuração guiada!