JinDaGe - system-resource-monitor MCP Details

article

README

🚀 系统资源监控 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

下载 Claude Desktop 此处。
将以下内容添加到 ~/.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

进入目录并安装依赖项：

cd system-resource-monitor && npm install

步骤 2：构建项目

编译 TypeScript 代码：

npm run build

这将生成 dist/index.js 文件，准备作为 MCP 服务器运行。

步骤 3：配置 Claude Desktop

下载 Claude Desktop 此处。
将以下内容添加到 ~/.config/claude/settings.json：

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

步骤 4：测试

打开终端并运行：

node dist/index.js

在另一个终端中运行：

npm start

📚 详细文档

高级自定义

要调整监控间隔，修改 config.json 中的 interval 参数。
要更改日志记录级别，修改 logLevel 参数。

故障排除

如果出现连接问题，请检查防火墙设置和端口配置。
如果未显示数据，请确保所有服务已正确启动。

📄 许可证

此项目受 MIT License 许可。

system-resource-monitor