Env

env-mcp is a practical MCP toolset that gathers current environment system information and exposes it through MCP client calls. It supports cross-platform usage, integrates easily with MCP-enabled applications, and includes TypeScript type support for strong typing in your projects.

How to use

You connect to env-mcp from an MCP client to retrieve a wide range of system data. Once configured, you can request platform, memory, CPU, network, user, and other environment information through clearly named endpoints. Each endpoint returns a structured data object that describes the current state of the host system, enabling you to build monitoring, auditing, or diagnostic features into your MCP-enabled applications.

How to install

Prerequisites you need before installing are Node.js and npm. Ensure Node.js is installed and available in your system PATH.

npm install @zhijianren/env-mcp -g

Configuration and usage notes

Configure an MCP client to load env-mcp as a local stdio server. The following configuration starts env-mcp via Node.js and points to the compiled entry at dist/index.js.

{
  "mcpServers": {
    "env_mcp": {
      "name": "env_mcp",
      "type": "stdio",
      "command": "node",
      "args": [
        "/usr/local/lib/node_modules/@zhijianren/env-mcp/dist/index.js"
      ],
      "enabled": true
    }
  }
}

Features and available data points

Env-mcp exposes a comprehensive set of data points that you can query from an MCP client. The following endpoints are described for reference. Each endpoint returns a structured object describing the requested information.

Available tools

getBatteryInfo

Retrieves the current device battery status including whether a battery is present, charging state, max capacity, and current capacity.

getGraphicsInfo

Obtains graphics controller details and displays information such as model, vendor, bus, and VRAM, along with connected displays and their resolutions.

getProcesses

Provides process information including total processes, running/blocked/sleeping counts, and a detailed list with pid, name, cpu, and memory usage.

getBluetoothInfo

Returns a list of Bluetooth devices with their name, address, and connection state.

getAudioInfo

Lists audio devices with their name, manufacturer, and whether it is the default device.

getAvailableNetworks

Gathers available network information including network interfaces and visible Wi‑Fi networks with detailed metadata.

getTimezone

Provides the current system timezone.

getAppSchemas

Fetches all registered wakeable App Schema information by bundle.

getWifiInfo

Returns current Wi‑Fi details such as SSID, BSSID, mode, channel, frequency, signal strength, quality, and security.

getInstalledApps

Lists all installed applications on the device.

getVpnInfo

Retrieves VPN configurations and details per key.

getHardwareInfo

Returns core hardware data including manufacturer, model, version, serial, uuid, sku, and whether the system is virtualized.

getPlatformInfo

Provides platform data such as platform name, architecture, hostname, system type, release, and version.

getMemoryInfo

Returns total, free, and used memory statistics.

getCpuInfo

Gives CPU information including models, speeds, and per-core times.

getNetworkInfo

Fetches network interface data with addresses, netmasks, family, MACs, and whether interfaces are internal.

getUserInfo

Provides current user information including UID, GID, username, home directory, and shell.

getCpuUsage

Reports current CPU usage as a percentage or descriptor string.

getDiskUsage

Returns disk usage information as a textual summary similar to df -h output.

getTerminalTypes

Lists all supported terminal types available on the system.

getIpv4Info

Gathers IPv4 address information per network interface.

getIpv6Info

Gathers IPv6 address information per network interface.

getProxyInfo

Retrieves configured HTTP/HTTPS proxies and no-proxy settings.

getUsbInfo

Lists connected USB devices with bus, device, vendor, product, serial, and type.

getPrinterInfo

Returns printer details such as name, status, type, and driver.

getSshPublicKey

Provides all found SSH public keys for the current user.

getDockerInfo

Provides Docker version, images, and containers information if Docker is available.

getNodeInfo

Returns installed Node.js versions and related runtime data including npm and environment details.