Monitor Remote Linux Server Health via SSH
Real-time CPU, memory, disk, network, and security monitoring for remote Linux servers over SSH.
1.0.0Add to Favorites
Why it matters
Gain real-time insights into the health and performance of your remote Linux servers. This asset collects comprehensive metrics including CPU, memory, disk, network, and security statistics, enabling proactive issue detection and system optimization.
Outcomes
What it gets done
Collect detailed CPU, memory, and disk usage metrics.
Monitor network interface statistics and security-related events.
Retrieve process lists and system alerts based on predefined thresholds.
Facilitate secure SSH connections for remote server monitoring.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-system-health | bash Capabilities
Tools your agent gets
General system health status information
Detailed CPU metrics
Memory and swap usage statistics
Disk usage for all or specific mount points
Network interface statistics
Security-related metrics
List of processes consuming the most CPU
Current alerts based on threshold violations
Comprehensive system health status summary
Overview
System Health MCP Server
System Health MCP Server gives Claude real-time CPU, memory, disk, network, and security metrics for remote Linux servers over SSH, with threshold-based alerts. Use it to monitor remote Linux servers and investigate resource or security issues. Currently supports Linux servers only and requires SSH access.
What it does
System Health MCP Server monitors remote Linux servers in real time over SSH, providing comprehensive metrics for CPU, memory, disk, network, and security, plus threshold-based alerts and a health summary.
When to use - and when NOT to
Use it to check system status, spot resource bottlenecks, or investigate security-relevant activity across one or more remote servers from Claude, e.g. by asking for CPU or memory metrics, disk usage for a given mount point, top CPU-consuming processes, or current threshold alerts. It currently supports Linux servers only and requires SSH access - it is not a Windows or containerized-host monitoring tool.
Capabilities
system_status: overall system status.cpu_metrics,memory_metrics,disk_metrics,network_metrics: detailed CPU, memory/swap, disk (all or specific mount points), and network interface metrics.security_metrics: security-related metrics, including failed login attempts and suspicious processes.process_list: top CPU-consuming processes.system_alerts: current alerts based on threshold violations.health_summary: a comprehensive system health summary.- Multi-server support (monitor several servers from one instance), SSH connection pooling and reuse, and preset alert thresholds: CPU (critical >=90%, warning >=80%), memory (critical >=95%, warning >=85%), disk (critical >=95%, warning >=85%).
How to install
git clone https://github.com/yourusername/mcp-system-health.git
cd mcp-system-health
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
Configure Claude Desktop with SSH connection details (username, password or key path, list of servers). Requires Python 3.10+ and SSH access to target servers; key-based authentication is recommended over passwords.
Who it's for
Sysadmins and DevOps engineers who want to check the health of remote Linux servers, or ask Claude about resource usage and security alerts, without logging into each server manually.
Source README
A robust real-time remote Linux server monitoring system that delivers comprehensive health and performance metrics, including CPU, memory, disk, network, and security statistics via SSH connections.
Installation
From Source
git clone https://github.com/yourusername/mcp-system-health.git
cd mcp-system-health
python -m venv venv
### On macOS/Linux:
source venv/bin/activate
### On Windows:
venv\Scripts\activate
pip install -r requirements.txt
Configuration
Claude Desktop
{
"mcpServers": {
"system-health": {
"command": "/path/to/your/venv/bin/python3",
"args": [
"/path/to/your/system-health-mcp-server/src/mcp_launcher.py",
"--username=your_ssh_username",
"--password=your_ssh_password",
"--key-path=~/.ssh/id_rsa",
"--servers=server1.example.com,server2.example.com",
"--log-level=debug"
],
"description": "System Health MCP Server for monitoring remote servers"
}
}
}
Server Configuration
{
"hostname": "server1",
"ip": "192.168.1.100",
"ssh_port": 22,
"username": "admin",
"key_path": "~/.ssh/id_rsa"
}
Available Tools
| Tool | Description |
|---|---|
system_status |
General system health status information |
cpu_metrics |
Detailed CPU metrics |
memory_metrics |
Memory and swap usage statistics |
disk_metrics |
Disk usage for all or specific mount points |
network_metrics |
Network interface statistics |
security_metrics |
Security-related metrics |
process_list |
List of processes consuming the most CPU |
system_alerts |
Current alerts based on threshold violations |
health_summary |
Comprehensive system health overview |
Features
- Comprehensive collection of CPU, memory, disk, network, and security metrics
- Real-time monitoring with system status checks
- Multi-server support for monitoring multiple servers from a single instance
- Threshold-based alerts for automatic detection of critical conditions
- SSH connection management with efficient pooling and connection reuse
- Security monitoring to track failed login attempts and suspicious processes
- Ready-to-use MCP integration for interaction with AI assistants
Resources
Notes
Requires Python 3.10+, SSH access to target servers, and currently supports Linux servers only. Alert thresholds are pre-configured for CPU (critical ≥90%, warning ≥80%), memory (critical ≥95%, warning ≥85%), disk (critical ≥95%, warning ≥85%), and security metrics. Key-based authentication is recommended over passwords for security.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.