System

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

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.