系统资源监控 MCP 服务器

一个提供实时系统监控功能的 MCP 服务器，包括 CPU、内存、磁盘、网络、电池和互联网速度指标，使用 systeminformation 和多源速度测试。

工具

• 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

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

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

步骤 4：测试

• 打开终端并运行：

  node dist/index.js
  

• 在另一个终端中运行：

  npm start
  

高级自定义

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

故障排除

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

许可证

此项目受 MIT License 许可。