System Info MCP Server

A comprehensive Model Context Protocol (MCP) server for system information, monitoring, and diagnostics. This server provides 18 tools to retrieve detailed information about CPU, memory, disk, network, processes, battery, hardware, and more.

Features

CPU Information: Get CPU model, cores, speed, architecture, and usage
Memory Information: Retrieve RAM and swap memory statistics
Operating System: Get OS details, version, hostname, and uptime
Disk Information: View disk usage for all mounted drives
Network Information: List network interfaces with IP addresses and status
Process Management: List running processes and system load
Battery Status: Check battery level, charging status, and health (laptops)
Hardware Details: Get graphics card, display, and peripheral information
Temperature Monitoring: Monitor CPU and GPU temperatures
Network Scanning: Scan for WiFi networks and Bluetooth devices
Port Information: List open network ports

Installation

Prerequisites

Node.js 18 or higher
npm or yarn

Install Dependencies

npm install

Build the Project

npm run build

Usage

Running the Server

The server runs on stdio transport and is designed to be used with MCP-compatible clients like Claude Desktop.

node dist/index.js

Claude Desktop Integration

To use this MCP server with Claude Desktop, add it to your Claude Desktop configuration:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "system-info": {
      "command": "node",
      "args": ["C:/Users/amogh/Downloads/mcp/dist/index.js"]
    }
  }
}

Note: Replace the path with the actual path to your dist/index.js file.

Available Tools

Tool	Description
`get_cpu_info`	CPU information including cores, model, speed, and usage
`get_memory_info`	RAM and swap memory statistics
`get_os_info`	Operating system details and version
`get_uptime`	System uptime information
`get_disk_info`	Disk usage for all mounted drives
`get_network_info`	Network interface information
`get_system_identity`	Hostname, username, and directory paths
`get_process_info`	Current process and total system processes
`list_processes`	List running processes with CPU/memory usage
`get_system_load`	System load averages
`get_battery_info`	Battery status and health (laptops)
`get_hardware_info`	Graphics, displays, and peripherals
`get_environment_info`	Environment variables (sensitive vars filtered)
`check_internet_connectivity`	Test internet connectivity and latency
`get_open_ports`	List open network ports
`get_temperature_info`	Hardware temperature sensors
`scan_wifi_networks`	Scan for available WiFi networks
`get_bluetooth_devices`	List paired Bluetooth devices

Example Usage with Claude

Once configured in Claude Desktop, you can ask Claude questions like:

"What's my CPU usage right now?"
"How much RAM do I have available?"
"Show me the top 10 processes by CPU usage"
"What's my battery level?"
"List all network interfaces"
"What's the temperature of my CPU?"
"Scan for WiFi networks"

Development

Project Structure

mcp-system-info/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── types/             # TypeScript type definitions
│   ├── tools/             # Tool implementations
│   ├── utils/             # Utility functions
│   └── config/            # Configuration constants
├── dist/                  # Compiled JavaScript
├── package.json
├── tsconfig.json
└── README.md

Build Scripts

# Build the project
npm run build

# Watch mode for development
npm run watch

# Run tests
npm test

# Lint code
npm run lint

Platform Support

Windows: Full support (Windows 10/11)
macOS: Full support (macOS 12+)
Linux: Full support (Ubuntu 20.04+, other distros)

Some features may have limited functionality on certain platforms:

Temperature monitoring is best on Linux
WiFi/Bluetooth scanning may require elevated privileges
Some hardware details vary by platform

Security

Environment variables containing sensitive keywords (API_KEY, PASSWORD, SECRET, TOKEN) are automatically filtered
Process command-line arguments are excluded to prevent secret exposure
No data is sent externally - all information stays local

Troubleshooting

Server won't start

Make sure you've built the project: npm run build
Check Node.js version: node --version (should be 18+)
Check for errors in stderr output

Tools return "NOT_AVAILABLE" errors

Some tools require:

Elevated permissions (admin/root)
Specific hardware (battery, WiFi adapter, etc.)
Platform support (some features are OS-specific)

Claude Desktop doesn't see the server

Verify the path in claude_desktop_config.json is correct
Make sure the path uses forward slashes (/) or escaped backslashes (\\)
Restart Claude Desktop after configuration changes

License

MIT

Version

1.0.0