System Resource Monitor

🚀 システムリソース監視MCPサーバー開発ガイド

このガイドでは、Node.jsをベースにしたMCP（Model Context Protocol）サーバーを構築し、システムリソースの状態をリアルタイムで監視する方法を詳しく説明します。このサーバーは複数のツール関数を提供し、ClaudeなどのAIモデルがCPU、メモリ、ディスク、ネットワーク、バッテリー、インターネット速度のリアルタイムデータを取得できるようにします。

✨ 主な機能

• システムリソース（CPU、メモリ、ディスク、ネットワーク、バッテリー、インターネット速度）のリアルタイム監視を提供します。
• 複数のツール関数を通じて、ClaudeなどのAIモデルがシステム情報を取得できます。

📦 インストール

必要なライブラリをインストールするには、以下のコマンドを実行してください。

npm install express systeminformation

📚 プロジェクト構造

• index.ts：メインエントリーファイルで、HTTPサーバーを起動し、各ツールを登録します。
• ツールディレクトリ：
  • get_cpu_usage.ts
  • get_memory_usage.ts
  • get_disk_space.ts
  • get_network_usage.ts
  • get_battery_status.ts
  • get_internet_speed.ts

🔧 技術詳細

コアコンポーネント

1. システム情報収集

すべてのツールはsysteminformationライブラリに基づいており、このライブラリはクロスプラットフォームのシステムリソース監視機能を提供します。

2. ツールの実装

(1) CPU使用率

• 機能：各コアの負荷率を取得します。

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) メモリ使用状況

• 機能：メモリの総量と使用率を報告します。

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) ディスク空き容量

• 機能：最大のパーティションの使用状況を監視します。

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) ネットワークトラフィック

• 機能：リアルタイムのネットワーク帯域幅を取得します。

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) バッテリー状態（モバイルデバイスのみ）

• 機能：バッテリーの充電状況を監視します。

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) ネットワーク速度テスト

• 機能：インターネット接続速度を測定します。

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';
    }
}

サーバーの実装

HTTPサービスの起動

expressフレームワークを使用して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());
});

// 他のルートも同様に実装

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

💻 使用例

curlコマンドを使用して各インターフェースを呼び出すことができます。

curl http://localhost:3000/system/cpu
curl http://localhost:3000/system/mem
# 他のインターフェースも同様に呼び出す

⚠️ 注意事項

⚠️ 重要提示

1. 権限要件：非rootユーザーで実行する場合、一部のシステム情報が取得できないことがあります。適切な権限でサービスを起動することをおすすめします。
2. パフォーマンス最適化：高頻度の呼び出しはリソース消費を増加させる可能性があります。適切なデータ収集間隔を設定することをおすすめします。
3. エラー処理：各ツールに十分な例外捕捉とログ記録を追加し、サービスの安定性を確保する必要があります。

まとめ

このガイドを通じて、開発者は機能が充実したシステムリソース監視MCPサーバーを迅速に構築することができます。このソリューションは既存のライブラリを利用して低レベルの実装を簡素化し、柔軟な拡張インターフェースを提供します。