SystemSage

Created 4 months ago

A powerful cross-platform system management and monitoring tool that provides comprehensive system insights and management capabilities through Model Context Protocol (MCP).

Visit Homepage

development documentation public system management monitoring

What is SystemSage?

A powerful, cross-platform system management and monitoring tool for Windows, Linux, and macOS.

Documentation

SystemSage

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)

pip install systemsage\n\n# With cloud features (Docker, Kubernetes)
pip install systemsage[cloud]
```\n\n### Using uv
```bash\n\n# Install uv first
pip install uv\n\n# Then install systemsage
uv pip install systemsage

Configuration# Cursor Desktop Setup\n\n#### Using uvx (recommended)

{
  "mcpServers": {
    "apple-books-mcp": {
      "command": "uvx",
      "args": [ "systemsage@latest" ]
    }
  }
}
```\n\n#### Using python
```json
{
  "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)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Server Config

{
  "mcpServers": {
    "systemsage-server": {
      "command": "npx",
      "args": [
        "systemsage"
      ]
    }
  }
}

Links & Status

Repository: github.com

Hosted: No

Global: No

Official: Yes

Project Info

Hosted Featured

Created At: Jul 22, 2025

Updated At: Aug 07, 2025

Author: Tarusharma1

Category: community

License: MIT License

Tags:

development documentation public