System Resource Monitor

🚀 System Resource Monitoring MCP Server Development Guide

This guide details how to build an MCP (Model Context Protocol) server based on Node.js for real - time monitoring of system resource status. The server offers multiple utility functions, allowing AI models like Claude to obtain real - time data on CPU, memory, disk, network, battery, and internet speed.

🚀 Quick Start

Project Structure

• index.ts: The main entry file that starts the HTTP server and registers each tool.
• Tool directories:
  • get_cpu_usage.ts
  • get_memory_usage.ts
  • get_disk_space.ts
  • get_network_usage.ts
  • get_battery_status.ts
  • get_internet_speed.ts

✨ Features

Core Components

1. System Information Collection

All tools are based on the systeminformation library, which provides cross - platform system resource monitoring capabilities.

2. Tool Implementation

(1) CPU Usage

• Function: Get the load percentage of each core.
• Implementation:

import { systeminformation } from 'systeminformation';

export async function getCpuUsage(): Promise<string> {
    const usage = await systeminformation.cpu();
    const cores = usage.map(u => u.usage.toFixed(2)).join(', ');
    return `CPU Load: ${usage[0].usage.toFixed(2)}% (Cores: ${cores})`;
}

(2) Memory Usage

• Function: Report the total memory and the percentage of used memory.

export async function getMemoryUsage(): Promise<string> {
    const mem = await systeminformation.mem();
    return `Memory: ${(mem.used / 1024 / 1024).toFixed(2)}GB used / ${(mem.total / 1024 / 1024).toFixed(2)}GB total (${((mem.used / mem.total) * 100).toFixed(2)}%)`;
}

(3) Disk Space

• Function: Monitor the usage of the largest partition.

export async function getDiskSpace(): Promise<string> {
    const stats = await systeminformation.diskSpace();
    const root = stats.find(s => s.mountpoint === '/');
    if (!root) return 'No disk space data available';
    return `Disk (/): ${((root.used / root.total) * 100).toFixed(2)}% used (${(root.used / 1024 / 1024).toFixed(2)}GB / ${(root.total / 1024 / 1024).toFixed(2)}GB)`;
}

(4) Network Traffic

• Function: Get real - time network bandwidth.

export async function getNetworkUsage(): Promise<string> {
    const net = await systeminformation.network();
    return `RX: ${net.rx_bytes.toFixed(2)}KB/s, TX: ${net.tx_bytes.toFixed(2)}KB/s`;
}

(5) Battery Status (Mobile Devices Only)

• Function: Monitor battery charging status.

export async function getBatteryStatus(): Promise<string> {
    const battery = await systeminformation.battery();
    if (!battery || !battery.isCharging) return 'No battery detected';
    return `Battery: ${battery.capacity}% (charging), ${(Math.floor(battery.timeLeft / 60)).toString()}min remaining`;
}

(6) Internet Speed Test

• Function: Measure the internet connection speed.

export async function getInternetSpeed(): Promise<string> {
    try {
        const speed = await systeminformation.internetSpeed();
        return `Download: ${speed.download.toFixed(2)}MB/s, Upload: ${speed.upload.toFixed(2)}MB/s`;
    } catch (e) {
        return 'Network test failed';
    }
}

Server Implementation

Starting the HTTP Service

• Use the express framework to build a REST API.

import express from 'express';
import { getCpuUsage, getMemoryUsage, getDiskSpace, getNetworkUsage, getBatteryStatus, getInternetSpeed } from './tools';

const app = express();
const port = 3000;

app.get('/system/cpu', async (req, res) => {
    res.send(await getCpuUsage());
});

app.get('/system/mem', async (req, res) => {
    res.send(await getMemoryUsage());
});

// Other routes are implemented similarly

app.listen(port, () => {
    console.log(`Server running at http://localhost:${port}`);
});

📦 Installation

Run the following command to install the required libraries:

npm install express systeminformation

💻 Usage Examples

Call each interface via the curl command:

curl http://localhost:3000/system/cpu
curl http://localhost:3000/system/mem
# Other interfaces are called similarly

📚 Documentation

Notes

⚠️ Important Note

1. Permission Requirements: When running under a non - root user, some system information may not be available. It is recommended to start the service with appropriate permissions.
2. Performance Optimization: High - frequency calls may lead to increased resource consumption. It is recommended to set a reasonable data collection interval.
3. Error Handling: Each tool should add sufficient exception catching and logging to ensure service stability.

Summary

Through this guide, developers can quickly set up a fully - functional system resource monitoring MCP server. This solution simplifies the underlying implementation by leveraging existing libraries and provides flexible extension interfaces.