Manage and Monitor System Resources
A cross-platform MCP server for system monitoring - CPU, memory, disk, network, process inspection, diagnostics, and Docker container control.
Why it matters
Automate system management and monitoring across platforms using the Model Context Protocol (MCP). Gain comprehensive analytics, manage processes, and monitor resources in real-time.
Outcomes
What it gets done
Monitor CPU, memory, and disk usage.
Manage system services and processes.
Perform system health and security checks.
Manage Docker containers.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-systemsage | bash Capabilities
Tools your agent gets
Get current CPU usage percentage
Get memory usage statistics
Get disk usage statistics
Get detailed network interface information
Monitor system resources in real-time
Get detailed process information
Find processes by name pattern
Check system alerts and issues
Overview
SystemSage MCP Server
This MCP server exposes 15 tools for system monitoring and diagnostics: CPU/memory/disk/network stats, process inspection, health checks, temp-file cleanup, and Docker container control, across Windows, macOS, and Linux. Use it for conversational system monitoring and diagnostics, with caution - some tools make destructive changes and some features require admin privileges. Back up data before system-critical operations.
What it does
A cross-platform system management and monitoring MCP server exposing 15 tools: get_cpu_usage, get_memory_usage, get_disk_usage, get_network_interfaces, monitor_system_resources with a duration parameter, get_process_details by pid, find_processes_by_name by name pattern, get_system_alerts, cleanup_temp_files, get_security_status, get_startup_programs, check_disk_health for SMART status, get_environment_variables, system_health_check, and manage_docker_containers taking an action and container_name. It lets an AI assistant answer questions like "which service is taking high resources," "can you close this service," or "check if internet is working" directly against the local system it's running on.
When to use - and when NOT to
Use it for conversational system monitoring, process inspection, diagnostics, temp-file cleanup, and Docker container control across Windows, macOS, and Linux - the documented tool table above doesn't include a separate tool for stopping arbitrary OS-level services or monitoring Kubernetes clusters, despite the project's own marketing copy describing broader ambitions in those areas. Take the project's own security caution seriously: cleaning up temp files and managing Docker containers make real, potentially destructive changes to the system, some features require administrator or root/sudo privileges that increase the blast radius of a mistake, and the project is provided "as is" with no warranty. Back up important data before system-critical operations and only grant elevated privileges when actually necessary.
Capabilities
Of the 15 tools, only two take any input at all: monitor_system_resources accepts a duration, and manage_docker_containers accepts an action plus a container_name; every other tool - including cleanup_temp_files and get_security_status - runs with no arguments and simply reports or acts on the whole local system in one call, which is why get_process_details and find_processes_by_name are the only two ways to narrow scope to a single process (by pid or by name pattern, respectively).
How to install
# Basic installation
pip install systemsage
# With cloud features (Docker, Kubernetes)
pip install systemsage[cloud]
Or via uv: pip install uv then uv pip install systemsage. Recommended Cursor Desktop config, using uvx:
{
"mcpServers": {
"systemsage": { "command": "uvx", "args": ["systemsage@latest"] }
}
}
Alternatively, run it with command python and args ["-m", "SystemSage"], or for local development from a cloned repo, point uv's --directory at the project path and run systemsage. Requires Python 3.10 or higher, psutil 5.9.0+, fastmcp 1.0.0+, and click 8.1.0+; optional requests, docker, and kubernetes packages unlock the cloud-specific dependencies referenced by the project, even though the documented tool table doesn't yet expose Kubernetes-specific tools.
Who it's for
Developers and sysadmins who want conversational system monitoring and diagnostics - especially those comfortable granting an AI assistant real control over Docker containers and local temp-file cleanup, and who understand the risk that comes with running privileged operations this way. It is distributed as a PyPI package under the MIT License, and the project welcomes pull requests through the standard fork, feature-branch, and PR workflow.
Source README
SystemSage
A powerful cross-platform system management and monitoring tool that provides comprehensive system insights and management capabilities through Model Context Protocol (MCP).
At a Glance
- Ask which services is taking high resources
- Ask can you close this [service name]
- Ask can u check internet is working
- Monitor system resources in real-time (CPU, Memory, Disk)
- Manage processes and services across different operating systems
- Track network interfaces and performance
- Monitor Docker containers and Kubernetes clusters
- Get instant system alerts and diagnostics
- Perform security checks and monitoring
- Manage system services efficiently
Available Tools
| Tool | Description | Parameters |
|---|---|---|
| get_cpu_usage() | Get current CPU usage percentage | None |
| get_memory_usage() | Get current memory usage statistics | None |
| get_disk_usage() | Get disk usage statistics | None |
| get_network_interfaces() | Get detailed network interface information | None |
| monitor_system_resources() | Monitor system resources over time | duration: int = 10 |
| get_process_details() | Get detailed information about a process | pid: int |
| find_processes_by_name() | Find processes by name pattern | name: str |
| get_system_alerts() | Check for system alerts and issues | None |
| cleanup_temp_files() | Clean up temporary files | None |
| get_security_status() | Check system security status | None |
| get_startup_programs() | List programs that start with system | None |
| check_disk_health() | Check disk health and SMART status | None |
| get_environment_variables() | Get system environment variables | None |
| system_health_check() | Comprehensive system health check | None |
| manage_docker_containers() | Manage Docker containers | action: str, container_name: str |
Installation
Using pip (recommended)
# Basic installation
pip install systemsage
# With cloud features (Docker, Kubernetes)
pip install systemsage[cloud]
Using uv
# Install uv first
pip install uv
# Then install systemsage
uv pip install systemsage
Configuration
Cursor Desktop Setup
Using uvx (recommended)
{
"mcpServers": {
"systemsage": {
"command": "uvx",
"args": [ "systemsage@latest" ]
}
}
}
Using python
{
"mcpServers": {
"systemsage": {
"command": "python",
"args": ["-m", "SystemSage"]
}
}
}
Debugging
If you cloned this repository, you can test it using Cursor Desktop with below configuration:
With Cursor Desktop
{
"mcpServers": {
"systemsage": {
"command": "uv",
"args": [
"--directory",
"/Path to project/SystemSage/",
"run",
"systemsage"
]
}
}
}
Features in Detail
System Monitoring
- Real-time CPU, Memory, and Disk usage tracking
- Network interface monitoring
- Process management and tracking
- System alerts and diagnostics
Service Management
- Start/Stop/Restart system services
- Monitor service status
- Enable/Disable services on boot
- Service health checks
Security Features
- System security status checks
- Failed login attempts monitoring
- Open ports scanning
- File system monitoring
Cloud Integration
- Docker container management
- Kubernetes cluster monitoring
- Cloud services status checking
- Database service monitoring
Performance Analysis
- System bottleneck detection
- Performance history tracking
- Resource usage trends
- System health scoring
Requirements
- Python 3.10 or higher
- psutil>=5.9.0
- fastmcp>=1.0.0
- click>=8.1.0
Optional Dependencies
- requests>=2.31.0 (for cloud services)
- docker>=6.1.0 (for Docker management)
- kubernetes>=28.1.0 (for Kubernetes monitoring)
Security Caution
SystemSage is a powerful tool that provides extensive control over your system. With great power comes great responsibility.
- Use with Caution: Many tools can make significant changes to your system, such as killing processes, managing services, or modifying files. Be sure you understand the commands you are running.
- Administrator Privileges: Some features require administrator (root/sudo) privileges to function. Running as an administrator increases the risk of unintended changes. Only use these privileges when necessary.
- No Guarantees: This tool is provided "as is" without any warranties. The developers are not responsible for any damage or data loss that may result from its use. Always back up important data before performing system-critical operations.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.