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.