SystemSage

SystemSage MCP is a cross‑platform system management and monitoring server that exposes real‑time insights and controls for CPU, memory, disk, processes, networks, Docker, Kubernetes, alerts, and security. You interact with it through an MCP client to query status, manage services and processes, monitor resources, and run diagnostic checks across your environment.

How to use

You connect to SystemSage MCP with an MCP client to perform common tasks such as checking current resource usage, managing services, and inspecting security or health status. Use the provided MCP endpoints to query metrics, start/stop services, inspect processes by PID or name, and troubleshoot issues across local or remote hosts. You can also orchestrate containerized workloads and cloud integration features when you have the appropriate environment.

How to install

Prerequisites you need before installing SystemSage MCP are Python 3.10 or higher and the Python package manager pip. You may also install the optional cloud features via extra dependencies.

pip install systemsage

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

# Install uv if you plan to run the MCP server locally with uvx
pip install uv

# Install SystemSage then prepare for direct MCP interaction
uv pip install systemsage

Configuration and runtime setup

You can run SystemSage MCP in local development mode via a standard runtime command, or use Cursor Desktop for a GUI-driven workflow. The following configurations demonstrate common runtime entry points that expose the MCP endpoints for you to connect with your client.

{
  "mcpServers": {
    "systemsage": {
      "command": "uvx",
      "args": ["systemsage@latest"]
    }
  }
}

{
  "mcpServers": {
    "systemsage": {
      "command": "python",
      "args": ["-m", "SystemSage"]
    }
  }
}

# Debugging / local test using Cursor Desktop
{
  "mcpServers": {
    "systemsage": {
      "command": "uv",
      "args": [
        "--directory",
        "/Path to project/SystemSage/",
        "run",
        "systemsage"
      ]
    }
  }
}

Notes:

• The first snippet starts the MCP server via uvx to fetch the latest SystemSage release.
• The second snippet starts SystemSage as a Python module. Use this if you prefer Python-based execution.
• The third snippet runs a local test through Cursor Desktop for immediate feedback.

## Available tools and capabilities (at a glance)

SystemSage exposes a comprehensive set of actions for monitoring and managing a system. You can query CPU, memory, and disk usage, inspect network interfaces, monitor resources over time, manage processes, control services, check security status, and observe Docker/Kubernetes environments. You can also perform system health checks and retrieve alerts for rapid diagnostics.

## Security and operational notes

SystemSage gives you powerful access across your system. Exercise caution and operate with the minimum required privileges. Some features require administrator or root access. Always back up important data before performing critical changes.

## Troubleshooting and tips

If you encounter connection issues, verify your MCP server configuration matches the runtime command you are using and confirm the client is pointing to the correct server endpoint. For local runs, ensure the directory paths are valid and that required dependencies are installed.

## Notes on environment and dependencies

Key requirements include Python 3.10+, psutil>=5.9.0, fastmcp>=1.0.0, and click>=8.1.0. Optional dependencies enable cloud integrations such as Docker and Kubernetes support.

## Examples of common MCP server configurations

Two common runtime configurations are shown below. Use the one that matches your environment.

{ "mcpServers": { "systemsage": { "command": "uvx", "args": ["systemsage@latest"] } } }

{ "mcpServers": { "systemsage": { "command": "python", "args": ["-m", "SystemSage"] } } }

## Available tools

### get\_cpu\_usage

Get current CPU usage percentage.

### get\_memory\_usage

Get current memory usage statistics.

### get\_disk\_usage

Get disk usage statistics.

### get\_network\_interfaces

Get detailed network interface information.

### monitor\_system\_resources

Monitor system resources over time with a configurable duration.

### get\_process\_details

Get detailed information about a process by PID.

### find\_processes\_by\_name

Find processes by name pattern.

### get\_system\_alerts

Check for system alerts and issues.

### cleanup\_temp\_files

Clean up temporary files.

### get\_security\_status

Check system security status.

### get\_startup\_programs

List programs that start with the system.

### check\_disk\_health

Check disk health and SMART status.

### get\_environment\_variables

Get system environment variables.

### system\_health\_check

Perform a comprehensive system health check.

### manage\_docker\_containers

Manage Docker containers with specified action and container name.