System Resource Monitor

🚀 系統資源監控 MCP 服務器

系統資源監控 MCP 服務器可提供即時系統監控功能，涵蓋 CPU、內存、磁盤、網絡、電池和互聯網速度等指標。它藉助 systeminformation 以及多源速度測試達成監控目的。

🚀 快速開始

克隆和安裝

克隆此倉庫：

git clone git@github.com:abhinav7895/system-mcp.git

進入目錄並安裝依賴項：

cd system-resource-monitor && npm install

構建項目

編譯 TypeScript 代碼：

npm run build

這將生成 dist/index.js 文件，可作為 MCP 服務器運行。

配置 Claude Desktop

1. 下載 Claude Desktop 此處。
2. 將以下內容添加到 ~/.config/claude/settings.json：

{
  "systemResourcesMonitor": {
    "enabled": true,
    "path": "dist/index.js"
  }
}

測試

• 打開終端並運行：

node dist/index.js

• 在另一個終端中運行：

npm start

✨ 主要特性

本系統資源監控 MCP 服務器具備以下工具，可獲取系統各項資源的使用情況：

• get_cpu_usage：獲取當前 CPU 使用率（百分比），涵蓋總體和每個核心的使用情況。
  • 輸入：無
  • 輸出：文本（例如，CPU 負載：12.34% (核心：10.50, 15.20, 8.90, 14.60%)）
• get_memory_usage：報告總內存、已用和空閒內存（單位：GB），以及使用百分比。
  • 輸入：無
  • 輸出：文本（例如，內存：65.43% 已用 (7.82GB / 16.00GB)）
• get_disk_space：顯示最大磁盤的使用情況（單位：GB）和百分比。
  • 輸入：無
  • 輸出：文本（例如，磁盤 (/)：78.90% 已用 (189.50GB / 250.00GB)）
• get_network_usage：返回即時網絡 RX/TX 速率（KB/s）和自啟動以來的總數據量（MB）。
  • 輸入：無
  • 輸出：文本（例如，網絡 (eth0)：RX：25.50KB/s，TX：10.20KB/s (總計：RX 150.34MB，TX 75.89MB)）
• get_battery_status：提供電池充電百分比、充電狀態和剩餘時間（如適用）。
  • 輸入：無
  • 輸出：文本（例如，電池：85% (正在充電)，120 分鐘剩餘 或 未檢測到電池）
• get_internet_speed：使用多個下載源（包括用戶上傳的文件）和上傳測試，返回中位數速度（單位：Mbps）。
  • 輸入：無
  • 輸出：文本（例如，互聯網速度：下載 45.67Mbps，上傳 8.45Mbps）

📦 安裝指南

安裝步驟如下：

1. 克隆倉庫：git clone git@github.com:abhinav7895/system-mcp.git
2. 進入目錄並安裝依賴：cd system-resource-monitor && npm install
3. 編譯 TypeScript 代碼：npm run build
4. 配置 Claude Desktop，添加配置到 ~/.config/claude/settings.json
5. 進行測試：分別在不同終端運行 node dist/index.js 和 npm start

🔧 技術細節

高級自定義

• 若要調整監控間隔，可修改 config.json 中的 interval 參數。
• 若要更改日誌記錄級別，可修改 logLevel 參數。

故障排除

• 若出現連接問題，請檢查防火牆設置和端口配置。
• 若未顯示數據，請確保所有服務已正確啟動。

📄 許可證

此項目受 MIT License 許可。