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