Labsco
cdmx1 logo

System Diagnostics

from cdmx1

An MCP server for system diagnostics and monitoring on Ubuntu using common command-line tools.

๐Ÿ”ฅ๐Ÿ”ฅ๐Ÿ”ฅโœ“ VerifiedFreeAdvanced setup

System Diagnostics MCP Server

A Model Context Protocol (MCP) server that provides comprehensive system diagnostics and monitoring capabilities for Ubuntu systems.

Features

๐Ÿง  Core Diagnostics

  • check_port โ€“ Test if a TCP port is open
  • ping_host โ€“ ICMP ping to a remote host
  • dns_lookup โ€“ Resolve DNS records for a domain
  • http_check โ€“ HTTP status check for a URL
  • traceroute_host โ€“ Trace network path to host
  • get_uptime โ€“ Return system uptime
  • get_sys_info โ€“ Basic system info (CPU, memory, disk)
  • get_hostname โ€“ Retrieve machine hostname

โš™๏ธ Service & Process Monitoring

  • list_processes โ€“ List running processes (like ps)
  • list_services โ€“ List systemd or init services
  • service_status โ€“ Status of a specific service
  • read_journal โ€“ Fetch latest logs for a unit or tag
  • cron_list โ€“ Show cron jobs for current user

๐Ÿ“ฆ Disk & Memory

  • check_disk_usage โ€“ Disk usage summary (like df)
  • check_memory โ€“ RAM/Swap usage (like free)
  • check_inode_usage โ€“ Filesystem inode stats
  • list_mounts โ€“ Mounted volumes

๐Ÿ”Œ Network & Ports

  • list_open_ports โ€“ Show open TCP/UDP ports
  • check_firewall_status โ€“ UFW/iptables summary
  • list_network_interfaces โ€“ IP, MAC, link state
  • check_bandwidth_usage โ€“ Network traffic stats
  • resolve_host โ€“ Reverse DNS for IP address
  • curl_url โ€“ GET request with curl, full headers

๐Ÿ”’ Security & Access

  • list_users โ€“ Local users
  • last_logins โ€“ Last login attempts
  • check_sudoers โ€“ Who can sudo
  • who_is_logged_in โ€“ Current sessions

Development

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