System Resource Monitor

システムリソース監視 MCP サーバー

systeminformation と複数のソースを使った速度テストにより、CPU、メモリ、ディスク、ネットワーク、バッテリー、インターネット速度のメトリクスなど、リアルタイムのシステム監視機能を Claude に提供する MCP サーバーです。

ツール

• get_cpu_usage

  • 全体およびコアごとの使用率を含む、現在の CPU 負荷をパーセンテージで取得します。
  • 入力：なし
  • 出力：テキスト（例：CPU Load: 12.34% (Cores: 10.50, 15.20, 8.90, 14.60%)）

• get_memory_usage

  • メモリの合計、使用量、空き容量を GB 単位で報告し、使用率も表示します。
  • 入力：なし
  • 出力：テキスト（例：Memory: 65.43% used (7.82GB / 16.00GB)）

• get_disk_space

  • 最大容量のドライブのディスク使用量を GB 単位とパーセンテージで表示します。
  • 入力：なし
  • 出力：テキスト（例：Disk (/): 78.90% used (189.50GB / 250.00GB)）

• get_network_usage

  • リアルタイムのネットワーク RX/TX 速度（KB/s）と、起動後のデータ総量（MB）を返します。
  • 入力：なし
  • 出力：テキスト（例：Network (eth0): RX: 25.50KB/s, TX: 10.20KB/s (Total: RX 150.34MB, TX 75.89MB)）

• get_battery_status

  • バッテリー残量、充電状態、残り時間（該当する場合）を取得します。
  • 入力：なし
  • 出力：テキスト（例：Battery: 85% (charging), 120 min remaining または No battery detected）

• get_internet_speed

  • 複数のダウンロードソース（ユーザーがアップロードしたファイルを含む）とアップロードテストを使ってインターネット速度を測定し、中央値を Mbps で返します。
  • 入力：なし
  • 出力：テキスト（例：Internet Speed: Download 45.67Mbps, Upload 8.45Mbps）

設定

ステップ 1：クローンとインストール

このリポジトリをクローンします：

git clone [email protected]:abhinav7895/system-mcp.git

ディレクトリに移動して、依存関係をインストールします：

cd system-resource-monitor && npm install

ステップ 2：プロジェクトをビルド

TypeScript コードをコンパイルします：

npm run build

これにより、MCP サーバーとして実行できる dist/index.js ファイルが生成されます。

ステップ 3：Claude Desktop を設定

1. Claude Desktop をこちらからダウンロードします。
2. claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "system-resource-monitor": {
      "command": "node",
      "args": ["/absolute/path/to/dist/index.js"]
    }
  }
}

設定ファイルにアクセスします：

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

（プロジェクトの場所に応じて、dist/index.js へのパスを調整してください。）

ステップ 4：テスト

ハンマーアイコンが表示されることを確認し、Claude Desktop がツールを認識しているか確認します：

ハンマーアイコンをクリックすると、利用可能なツールが表示されます：

6 つのツール（get_cpu_usage、get_memory_usage など）がすべて表示されれば、連携は有効です。次のような質問をしてみましょう：

• 「CPU 使用率はどれくらいですか？」
• 「インターネットの速度はどれくらいですか？」

ステップ 5：高度なカスタマイズ

• インターネット速度テスト：index.ts の testUrls を変更して別のダウンロードソースを使用したり、アップロードテストの uploadSizeBytes（デフォルトは 80KB）を調整したりできます。
• ログ記録：コンソールログにはテストの詳細な出力が表示されます。本番環境では console.log 文を削除して無効にしてください。

トラブルシューティング

• ツールが表示されない：サーバーが実行中（node dist/index.js）であり、設定パスが正しいことを確認してください。
• インターネット速度のエラー：ネットワークに接続できていることと、テスト URL にアクセスできることを確認してください。具体的な失敗内容はコンソールログで確認してください。
• MCP トラブルシューティングガイドを参照してください。

ライセンス

この MCP サーバーは MIT ライセンスの下でライセンスされています。MIT ライセンスの条件に従って、ソフトウェアを自由に使用、変更、配布できます。詳しくは LICENSE ファイルを参照してください。