system-mcp

A local MCP server (Python + uv) that exposes system telemetry tools:

• CPU usage and core/frequency metrics

• RAM and swap usage

• Disk usage and IO

• Battery status

• Network counters

• Running task/process stats

• GPU metrics (via nvidia-smi when available)

1) Install

uv sync

Related MCP server: System Info MCP Server

2) Run server (stdio transport)

uv run system-mcp

3) MCP client configuration example

Use this command in your MCP client config:

• Command: uv

• Args: run, system-mcp

• Working directory: this project root

Example JSON snippet:

{
  "mcpServers": {
    "system-mcp": {
      "command": "uv",
      "args": ["run", "system-mcp"],
      "cwd": "k:/Tech/Projects/system_mcp"
    }
  }
}

Exposed tools

• system_overview

• cpu_metrics(sample_seconds=1.0)

• memory_metrics

• disk_metrics(path="C:\\")

• battery_metrics

• network_metrics

• running_tasks(limit=10, sort_by="cpu")

• gpu_metrics

Notes

• gpu_metrics depends on nvidia-smi being available in PATH.

• On systems without battery/GPU, tools return availability flags and messages instead of failing.