System Diagnostics

System Diagnostics is an MCP server that provides comprehensive system diagnostics and monitoring capabilities for Ubuntu and Debian-based Linux environments. It connects AI assistants directly to standard operating system utilities such as ping, dig, traceroute, systemctl, ps, df, free, and curl over standard input and output. System administrators, DevOps engineers, and developers use this server to inspect server health, analyze performance bottlenecks, and resolve network issues through natural language interactions. By exposing native diagnostics tools as Model Context Protocol functions, the server enables AI models to audit open ports, inspect running processes, retrieve systemd service logs, measure memory and disk consumption, check active user sessions, and evaluate firewall rules. This eliminates the need to manually execute terminal commands and copy outputs back and forth during routine administrative tasks or incident troubleshooting.

Category: Cloud & Infrastructure

Tags: diagnostics, linux, monitoring, sysadmin, ubuntu

Visit System Diagnostics

How to install and configure System Diagnostics

1. Ensure you are running Python 3.8+ on an Ubuntu or Debian-based system with standard tools installed (such as ping, dig, traceroute, systemctl, ps, df, free, and curl). 2. Install the package using uv by running uv pip install system-diag-mcp, or install using standard pip with pip install system-diag-mcp. 3. Configure your MCP client. For Claude Desktop, edit your configuration file and add the server definition: json { "mcpServers": { "system-diag": { "command": "system-diag-mcp" } } } 4. Restart your MCP client to start using the system diagnostics tools.

What you can do with System Diagnostics

• Investigating server resource exhaustion by checking RAM, swap, filesystem disk capacity, and inode usage through simple conversational queries. - Auditing network connectivity and domain configurations using built-in ICMP ping, traceroute, HTTP endpoint checks, and DNS resolution tools. - Reviewing active systemd services and parsing recent systemd journal logs to troubleshoot failed background daemons and service crashes. - Inspecting open network ports, current firewall configuration states, and network interface status to verify host security boundaries. - Tracking active user sessions, recent login history, and sudoers permissions to audit host access during security investigations.

Key facts

• https://github.com/cdmx1/system-diag-mcp
• Cloud & Infrastructure, Monitoring & Observability
• diagnostics, linux, monitoring, sysadmin, ubuntu

Part of MCP Servers

How do I install System Diagnostics?

You can install System Diagnostics on an Ubuntu or Debian-based Linux system running Python 3.8 or higher. Install it using the Python package installer by executing pip install system-diag-mcp, or use uv with the command uv pip install system-diag-mcp.

What can System Diagnostics do?

System Diagnostics enables an AI assistant to run diagnostic and monitoring checks on an Ubuntu host. It can test open ports, perform ping and traceroute queries, inspect running processes, monitor systemd service statuses, check memory and disk usage, read journal logs, and audit logged-in users.

Which MCP clients work with System Diagnostics?

System Diagnostics works with any Model Context Protocol client that supports local stdio transport. This includes Claude Desktop, Cursor, and other custom developer environments that can spawn a local command line executable.

What are the system requirements for System Diagnostics?

The server requires Python 3.8 or newer on an Ubuntu or Debian-based operating system. It relies on standard CLI utilities being available on the system path, including ping, dig, traceroute, systemctl, ps, df, free, and curl.

Is System Diagnostics open source?

Yes, System Diagnostics is open source software published under the MIT License on GitHub.