System Diagnostics

System Diagnostics MCP Server

Um servidor Model Context Protocol (MCP) que fornece recursos abrangentes de diagnóstico e monitoramento de sistemas para sistemas Ubuntu.

Funcionalidades

🧠 Diagnóstico Principal

• check_port – Testa se uma porta TCP está aberta
• ping_host – Ping ICMP para um host remoto
• dns_lookup – Resolve registros DNS para um domínio
• http_check – Verificação de status HTTP para uma URL
• traceroute_host – Traça o caminho de rede até o host
• get_uptime – Retorna o tempo de atividade do sistema
• get_sys_info – Informações básicas do sistema (CPU, memória, disco)
• get_hostname – Obtém o hostname da máquina

⚙️ Monitoramento de Serviços e Processos

• list_processes – Lista processos em execução (como ps)
• list_services – Lista serviços systemd ou init
• service_status – Status de um serviço específico
• read_journal – Busca os logs mais recentes de uma unidade ou tag
• cron_list – Mostra tarefas cron do usuário atual

📦 Disco e Memória

• check_disk_usage – Resumo do uso de disco (como df)
• check_memory – Uso de RAM/Swap (como free)
• check_inode_usage – Estatísticas de inodes do sistema de arquivos
• list_mounts – Volumes montados

🔌 Rede e Portas

• list_open_ports – Mostra portas TCP/UDP abertas
• check_firewall_status – Resumo do UFW/iptables
• list_network_interfaces – IP, MAC, estado do link
• check_bandwidth_usage – Estatísticas de tráfego de rede
• resolve_host – DNS reverso para endereço IP
• curl_url – Requisição GET com curl, cabeçalhos completos

🔒 Segurança e Acesso

• list_users – Usuários locais
• last_logins – Últimas tentativas de login
• check_sudoers – Quem pode usar sudo
• who_is_logged_in – Sessões atuais

Instalação

Usando uv (recomendado)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install the package
uv pip install system-diag-mcp

Usando pip

pip install system-diag-mcp

Uso

Como servidor autônomo

system-diag-mcp

Com o Claude Desktop

Adicione isto à sua configuração do Claude Desktop:

{
  "mcpServers": {
    "system-diag": {
      "command": "system-diag-mcp"
    }
  }
}

Com outros clientes MCP

O servidor executa em stdio e implementa o protocolo MCP completo.

Desenvolvimento

# Clone the repository
git clone <repository-url>
cd system-diag-mcp

# Install development dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Format code
black .
ruff check .

Requisitos

• Python 3.8+
• Sistema baseado em Ubuntu/Debian
• Ferramentas de sistema necessárias: ping, dig, traceroute, systemctl, ps, df, free, curl

Licença

MIT License