System Resource Monitor

系统资源监控 MCP 服务

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

工具

• 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）

配置

步骤 1：克隆并安装

克隆此代码库：

git clone [email protected]: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. 将以下内容添加到你的 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 的路径。）

步骤 4：测试

查看是否显示锤子图标，以确认 Claude Desktop 已识别这些工具：

点击锤子图标，查看可用工具：

如果显示全部 6 个工具（get_cpu_usage、get_memory_usage 等），则表示集成已启用。现在你可以提出如下问题：

• “我的 CPU 使用率是多少？”
• “我的网速有多快？”

步骤 5：高级自定义

• 网速测试：修改 index.ts 中的 testUrls 以使用不同的下载源，或调整上传测试的 uploadSizeBytes（默认值为 80KB）。
• 日志记录：控制台日志会提供详细的测试输出；在生产环境中，可通过移除 console.log 语句来禁用日志。

故障排除

• 未显示工具：确认服务正在运行（node dist/index.js），并检查配置路径是否正确。
• 网速测试错误：确保网络连接正常，并且测试 URL 可访问。查看控制台日志以了解具体故障。
• 参阅 MCP 故障排除指南

许可证

此 MCP 服务采用 MIT License 授权。你可以根据 MIT License 的条款自由使用、修改和分发此软件。详情请参阅 LICENSE 文件。