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)

pip install systemsage

# With cloud features (Docker, Kubernetes)
pip install systemsage[cloud]

Using uv

pip install uv

# Then install systemsage
uv pip install systemsage

Configuration# Cursor Desktop Setup

Using uvx (recommended)

{
    "mcpServers": {
        "apple-books-mcp": {
            "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"
            ]
        }
    }
}
```\n\n## 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.