Provides tools for listing paired Bluetooth devices and managing Bluetooth connectivity information on the local system.
Offers comprehensive system monitoring and information retrieval capabilities for Linux systems, including hardware details, processes, and system metrics.
Provides system information and monitoring tools specifically designed for macOS environments, enabling detailed hardware and system state analysis.
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
Build the Project
Usage
Running the Server
The server runs on stdio transport and is designed to be used with MCP-compatible clients like Claude Desktop.
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:
Note: Replace the path with the actual path to your dist/index.js
file.
Available Tools
Tool | Description |
| CPU information including cores, model, speed, and usage |
| RAM and swap memory statistics |
| Operating system details and version |
| System uptime information |
| Disk usage for all mounted drives |
| Network interface information |
| Hostname, username, and directory paths |
| Current process and total system processes |
| List running processes with CPU/memory usage |
| System load averages |
| Battery status and health (laptops) |
| Graphics, displays, and peripherals |
| Environment variables (sensitive vars filtered) |
| Test internet connectivity and latency |
| List open network ports |
| Hardware temperature sensors |
| Scan for available WiFi networks |
| 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
Build Scripts
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 correctMake sure the path uses forward slashes (/) or escaped backslashes (\\)
Restart Claude Desktop after configuration changes
License
MIT
Version
1.0.0
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Enables comprehensive system monitoring and diagnostics through 18 tools that provide detailed information about CPU, memory, disk usage, network interfaces, running processes, battery status, hardware details, and temperature monitoring. Allows users to query system information and performance metrics through natural language interactions.