
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 .Copy & paste โ that's it
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install the package
uv pip install system-diag-mcpInstallation
Using uv (recommended)
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install the package
uv pip install system-diag-mcpUsing pip
pip install system-diag-mcpUsage
As a standalone server
system-diag-mcpWith Claude Desktop
Add this to your Claude Desktop configuration:
{
"mcpServers": {
"system-diag": {
"command": "system-diag-mcp"
}
}
}With other MCP clients
The server runs on stdio and implements the full MCP protocol.
Requirements
- Python 3.8+
- Ubuntu/Debian-based system
- Required system tools:
ping,dig,traceroute,systemctl,ps,df,free,curl
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.
Licensed under MITโ you can use, modify, and redistribute it under that license's terms.
License
MIT License