System Resource Monitor MCP Server

System Resource Monitor MCP Server

site icon
2025.03.22 0
TypeScript系统监控资源管理其它
System Resource Monitor MCP Server 是一个为Claude提供实时系统监控能力的MCP服务器。它能够监控CPU、内存、磁盘、网络、电池和互联网速度等系统资源,使用`systeminformation`和多源速度测试工具。
View on GitHub

Overview

基本能力

产品定位

System Resource Monitor MCP Server 是一个系统资源监控工具,旨在为Claude提供实时系统监控能力。

核心功能

  • 实时监控CPU使用率(包括整体和每个核心的使用情况)
  • 报告内存使用情况(总内存、已用内存、空闲内存及使用百分比)
  • 显示磁盘空间使用情况(最大驱动器的使用量和百分比)
  • 提供实时网络接收/发送速率及自启动以来的总数据量
  • 报告电池电量百分比、充电状态和剩余时间(如适用)
  • 测量互联网速度(下载和上传速度,使用多个下载源和上传测试)

适用场景

  • 系统管理员需要实时监控服务器资源使用情况
  • 开发人员需要调试性能问题时监控系统资源
  • 普通用户想要了解自己电脑的资源使用情况
  • 需要测试互联网连接速度的场景

工具列表

  1. get_cpu_usage
  2. 功能:检索当前CPU负载百分比,包括整体和每个核心的使用情况
  3. 输入:无
  4. 输出:文本(例如:CPU Load: 12.34% (Cores: 10.50, 15.20, 8.90, 14.60%)

  5. get_memory_usage

  6. 功能:报告总内存、已用内存和空闲内存(以GB为单位)及使用百分比
  7. 输入:无
  8. 输出:文本(例如:Memory: 65.43% used (7.82GB / 16.00GB)

  9. get_disk_space

  10. 功能:显示最大驱动器的磁盘使用量(以GB为单位)和百分比
  11. 输入:无
  12. 输出:文本(例如:Disk (/): 78.90% used (189.50GB / 250.00GB)

  13. get_network_usage

  14. 功能:返回实时网络接收/发送速率(KB/s)和自启动以来的总数据量(MB)
  15. 输入:无
  16. 输出:文本(例如:Network (eth0): RX: 25.50KB/s, TX: 10.20KB/s (Total: RX 150.34MB, TX 75.89MB)

  17. get_battery_status

  18. 功能:提供电池电量百分比、充电状态和剩余时间(如适用)
  19. 输入:无
  20. 输出:文本(例如:Battery: 85% (charging), 120 min remainingNo battery detected

  21. get_internet_speed

  22. 功能:使用多个下载源(包括用户上传的文件)和上传测试测量互联网速度,返回中位数速度(Mbps)
  23. 输入:无
  24. 输出:文本(例如:Internet Speed: Download 45.67Mbps, Upload 8.45Mbps

常见问题解答

  • 工具未显示:验证服务器是否正在运行(node dist/index.js)且配置路径正确
  • 互联网速度测试错误:确保网络连接正常且测试URL可访问。检查控制台日志以获取具体失败信息
  • 参考MCP故障排除指南

使用教程

使用依赖

  1. 确保已安装Node.js和npm
  2. 确保已安装Git

安装教程

  1. 克隆仓库:
git clone [email protected]:abhinav7895/system-mcp.git
  1. 进入目录并安装依赖:
cd system-resource-monitor && npm install
  1. 编译TypeScript代码:
npm run build

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

  1. 配置Claude Desktop:
  2. 下载Claude Desktop here
  3. 将以下内容添加到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的路径)

调试方式

  1. 确保Claude Desktop识别工具:检查锤子图标
  2. 点击锤子图标查看可用工具
  3. 如果所有六个工具都出现,集成已激活
  4. 可以询问类似以下问题:
  5. "What’s my CPU usage?"
  6. "How fast is my internet?"
  7. 高级定制:
  8. 修改index.ts中的testUrls以使用不同的下载源
  9. 调整uploadSizeBytes(默认80KB)进行上传测试
  10. 生产环境中可通过删除console.log语句禁用详细日志

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。