Skip to content

system ​

Read-only system information. Pure inspection, no I/O — auto-registered by the installer.

Usage ​

bash
native-mcp system

No flags.

Tools ​

info ​

Hostname, OS, architecture, CPU count, Go runtime version, current user, working directory.

network_interfaces ​

List network interfaces with their flags, MTU, MAC, and IPv4/IPv6 addresses.

meminfo (Linux only) ​

Parses /proc/meminfo and returns the headline numbers (MemTotal, MemFree, MemAvailable, Buffers, Cached, SwapTotal, SwapFree). Returns an error on macOS/Windows.

disk_usage (Unix only) ​

FieldTypeRequiredDescription
pathstringnoPath inside the filesystem to inspect (default /).

Returns total/free/available/used bytes plus a human-readable size and used percentage. Backed by syscall.Statfs.

uptime (Linux only) ​

Parses /proc/uptime and returns the system uptime as a duration plus the boot time as RFC 3339.

env ​

FieldTypeRequiredDescription
namestringyesEnvironment variable name.

Returns the value or (unset). Refuses to read variables whose name contains PASSWORD, SECRET, TOKEN, KEY, CREDENTIAL, or PRIVATE — a small guard against accidentally surfacing secrets to the model. There is no override; choose a different name if you need to expose one of those.

Register in Claude Code ​

bash
claude mcp add native-system native-mcp system

Released under the MIT License.