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

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)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

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

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.