@jkumonpm/system-info-mcp

System Info MCP server. OS, memory, disk, and process information.

No external dependencies. Pure Node.js os + child_process.

Install

npm install -g @jkumonpm/system-info-mcp

Usage

Claude Desktop / Cursor / OpenCode

Add to your MCP config:

{
  "mcpServers": {
    "system-info": {
      "command": "npx",
      "args": ["-y", "@jkumonpm/system-info-mcp"]
    }
  }
}

Tools

get_os_info — Get OS Info

Get operating system and version information.

Input:

{}

Output:

{
  "platform": "win32",
  "type": "Windows_NT",
  "release": "10.0.19045",
  "arch": "x64",
  "hostname": "DESKTOP-ABC123",
  "username": "user",
  "nodeVersion": "v20.11.0"
}

get_memory_usage — Get Memory Usage

Get system memory usage status.

Input:

{}

Output:

{
  "total": "16.00 GB",
  "used": "10.24 GB",
  "free": "5.76 GB",
  "usagePercent": "64.0%"
}

get_disk_space — Get Disk Space

Get disk space information for a given path.

Input:

{
  "path": "/"
}

Output (Windows):

{
  "drives": {
    "Name": "C",
    "Total": 1023237156864,
    "Used": 705506168832,
    "Free": 317730988032
  }
}

Output (macOS/Linux):

{
  "Filesystem": "/dev/sda1",
  "Size": "100G",
  "Used": "50G",
  "Avail": "50G",
  "Use%": "50%",
  "Mounted": "/"
}

list_processes — List Processes

List top processes by resource usage.

Input:

{
  "limit": 10
}

Output:

{
  "count": 10,
  "processes": [
    {
      "Id": 1234,
      "ProcessName": "chrome",
      "MemoryMB": 512.5,
      "CPU": 15.2
    }
  ]
}

Design

| Feature | Why | |---------|-----| | Zero runtime deps | Only @modelcontextprotocol/sdk and zod | | Native os module | Direct access to system information | | Cross-platform | Windows (PowerShell), macOS/Linux (df/ps) | | Structured output | AI reads system info precisely |

License

MIT