A powerful cross-platform system management and monitoring tool that provides comprehensive system insights and management capabilities through Model Context Protocol (MCP).
- 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
| 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 |
# Basic installation
pip install systemsage
# With cloud features (Docker, Kubernetes)
pip install systemsage[cloud]# Install uv first
pip install uv
# Then install systemsage
uv pip install systemsage{
"mcpServers": {
"apple-books-mcp": {
"command": "uvx",
"args": [ "systemsage@latest" ]
}
}
}{
"mcpServers": {
"systemsage": {
"command": "python",
"args": ["-m", "SystemSage"]
}
}
}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"
]
}
}
}- Real-time CPU, Memory, and Disk usage tracking
- Network interface monitoring
- Process management and tracking
- System alerts and diagnostics
- Start/Stop/Restart system services
- Monitor service status
- Enable/Disable services on boot
- Service health checks
- System security status checks
- Failed login attempts monitoring
- Open ports scanning
- File system monitoring
- Docker container management
- Kubernetes cluster monitoring
- Cloud services status checking
- Database service monitoring
- System bottleneck detection
- Performance history tracking
- Resource usage trends
- System health scoring
- Python 3.10 or higher
- psutil>=5.9.0
- fastmcp>=1.0.0
- click>=8.1.0
- requests>=2.31.0 (for cloud services)
- docker>=6.1.0 (for Docker management)
- kubernetes>=28.1.0 (for Kubernetes monitoring)
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
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.