Skip to main content
Glama
system-mcp

system-mcp

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.

Available Tools

8 tools
battery_metricsA

Get battery status, charge level, and charging state.

Inputs: no named parameters. Returns: object

cpu_metricsC

Get detailed CPU metrics.

Inputs: sample_seconds. Returns: object

disk_metricsB

Get disk usage and IO counters for a given path.

Inputs: path. Returns: object

gpu_metricsA

Get GPU information if available (nvidia-smi based).

Inputs: no named parameters. Returns: object

memory_metricsA

Get RAM and swap usage details.

Inputs: no named parameters. Returns: object

network_metricsA

Get system network traffic counters and active connection count.

Inputs: no named parameters. Returns: object

running_tasksB

Get top running tasks/processes sorted by CPU or memory.

Inputs: limit, sort_by. Returns: object

system_overviewA

Get an overall system summary: OS, CPU, RAM, disk, battery, and process count.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool targets a distinct system component (battery, CPU, disk, GPU, memory, network, processes, and overview) with no functional overlap.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with descriptive suffixes like _metrics, _tasks, _overview.

    Tool Count5/5

    8 tools is well-scoped for a system monitoring server, covering major resources without being excessive or too sparse.

    Completeness4/5

    Core system metrics are covered, but lacks deeper details like per-interface network stats or sensor data, which are minor gaps.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables comprehensive system monitoring and diagnostics through 18 tools that provide detailed information about CPU, memory, disk usage, network interfaces, running processes, battery status, hardware details, and temperature monitoring. Allows users to query system information and performance metrics through natural language interactions.
      10 npm
      ISC
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables real-time monitoring of system resources including CPU, GPU (NVIDIA, Apple Silicon, AMD/Intel), memory, disk, network, and processes across Windows, macOS, and Linux platforms through natural language queries.
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Exposes Windows system information and control tools including hardware stats, network details, and process monitoring. It enables AI applications to retrieve real-time data about CPU, memory, drives, and active system processes.
      12
      GPL 3.0