System Diagnostics

Servidor MCP de Diagnóstico del Sistema

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona capacidades integrales de diagnóstico y monitoreo del sistema para sistemas Ubuntu.

Características

🧠 Diagnóstico Principal

• check_port – Prueba si un puerto TCP está abierto
• ping_host – Ping ICMP a un host remoto
• dns_lookup – Resuelve registros DNS para un dominio
• http_check – Verificación de estado HTTP para una URL
• traceroute_host – Traza la ruta de red hasta el host
• get_uptime – Devuelve el tiempo de actividad del sistema
• get_sys_info – Información básica del sistema (CPU, memoria, disco)
• get_hostname – Obtiene el nombre de host de la máquina

⚙️ Monitoreo de Servicios y Procesos

• list_processes – Lista los procesos en ejecución (como ps)
• list_services – Lista los servicios systemd o init
• service_status – Estado de un servicio específico
• read_journal – Obtiene los registros más recientes de una unidad o etiqueta
• cron_list – Muestra los trabajos cron del usuario actual

📦 Disco y Memoria

• check_disk_usage – Resumen de uso del disco (como df)
• check_memory – Uso de RAM/Swap (como free)
• check_inode_usage – Estadísticas de inodos del sistema de archivos
• list_mounts – Volúmenes montados

🔌 Red y Puertos

• list_open_ports – Muestra los puertos TCP/UDP abiertos
• check_firewall_status – Resumen de UFW/iptables
• list_network_interfaces – IP, MAC, estado del enlace
• check_bandwidth_usage – Estadísticas de tráfico de red
• resolve_host – DNS inverso para una dirección IP
• curl_url – Solicitud GET con curl, encabezados completos

🔒 Seguridad y Acceso

• list_users – Usuarios locales
• last_logins – Últimos intentos de inicio de sesión
• check_sudoers – Quién puede usar sudo
• who_is_logged_in – Sesiones actuales

Instalación

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 independiente

system-diag-mcp

Con Claude Desktop

Agrega esto a tu configuración de Claude Desktop:

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

Con otros clientes MCP

El servidor se ejecuta en stdio e implementa el protocolo MCP completo.

Desarrollo

# 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 basado en Ubuntu/Debian
• Herramientas del sistema requeridas: ping, dig, traceroute, systemctl, ps, df, free, curl

Licencia

Licencia MIT