
System Resource Monitor MCP Server

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使用率(包括整体和每个核心的使用情况)
- 报告内存使用情况(总内存、已用内存、空闲内存及使用百分比)
- 显示磁盘空间使用情况(最大驱动器的使用量和百分比)
- 提供实时网络接收/发送速率及自启动以来的总数据量
- 报告电池电量百分比、充电状态和剩余时间(如适用)
- 测量互联网速度(下载和上传速度,使用多个下载源和上传测试)
适用场景
- 系统管理员需要实时监控服务器资源使用情况
- 开发人员需要调试性能问题时监控系统资源
- 普通用户想要了解自己电脑的资源使用情况
- 需要测试互联网连接速度的场景
工具列表
- get_cpu_usage
- 功能:检索当前CPU负载百分比,包括整体和每个核心的使用情况
- 输入:无
-
输出:文本(例如:
CPU Load: 12.34% (Cores: 10.50, 15.20, 8.90, 14.60%)
) -
get_memory_usage
- 功能:报告总内存、已用内存和空闲内存(以GB为单位)及使用百分比
- 输入:无
-
输出:文本(例如:
Memory: 65.43% used (7.82GB / 16.00GB)
) -
get_disk_space
- 功能:显示最大驱动器的磁盘使用量(以GB为单位)和百分比
- 输入:无
-
输出:文本(例如:
Disk (/): 78.90% used (189.50GB / 250.00GB)
) -
get_network_usage
- 功能:返回实时网络接收/发送速率(KB/s)和自启动以来的总数据量(MB)
- 输入:无
-
输出:文本(例如:
Network (eth0): RX: 25.50KB/s, TX: 10.20KB/s (Total: RX 150.34MB, TX 75.89MB)
) -
get_battery_status
- 功能:提供电池电量百分比、充电状态和剩余时间(如适用)
- 输入:无
-
输出:文本(例如:
Battery: 85% (charging), 120 min remaining
或No battery detected
) -
get_internet_speed
- 功能:使用多个下载源(包括用户上传的文件)和上传测试测量互联网速度,返回中位数速度(Mbps)
- 输入:无
- 输出:文本(例如:
Internet Speed: Download 45.67Mbps, Upload 8.45Mbps
)
常见问题解答
- 工具未显示:验证服务器是否正在运行(
node dist/index.js
)且配置路径正确 - 互联网速度测试错误:确保网络连接正常且测试URL可访问。检查控制台日志以获取具体失败信息
- 参考MCP故障排除指南
使用教程
使用依赖
- 确保已安装Node.js和npm
- 确保已安装Git
安装教程
- 克隆仓库:
git clone [email protected]:abhinav7895/system-mcp.git
- 进入目录并安装依赖:
cd system-resource-monitor && npm install
- 编译TypeScript代码:
npm run build
这将生成dist/index.js
文件,准备作为MCP服务器运行。
- 配置Claude Desktop:
- 下载Claude Desktop here
- 将以下内容添加到
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
的路径)
调试方式
- 确保Claude Desktop识别工具:检查锤子图标
- 点击锤子图标查看可用工具
- 如果所有六个工具都出现,集成已激活
- 可以询问类似以下问题:
- "What’s my CPU usage?"
- "How fast is my internet?"
- 高级定制:
- 修改
index.ts
中的testUrls
以使用不同的下载源 - 调整
uploadSizeBytes
(默认80KB)进行上传测试 - 生产环境中可通过删除
console.log
语句禁用详细日志