系统资源监控 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

  • 返回实时的网络 RX/TX 速率 (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 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. 将以下内容添加到您的 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 识别这些工具:

单击锤子图标以查看可用的工具:

如果所有六个工具 (get_cpu_usage, get_memory_usage 等) 出现，则集成已激活。 您现在可以问以下问题:

• "我的 CPU 使用率是多少?"
• "我的互联网速度有多快?"

步骤 5: 高级自定义

• 互联网速度测试: 修改 index.ts 中的 testUrls 以使用不同的下载源，或调整 uploadSizeBytes (默认为 80KB) 以进行上传测试。
• 日志记录: 控制台日志提供详细的测试输出; 在生产环境中禁用它们，方法是删除 console.log 语句。

故障排除

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

许可证

此 MCP 服务器是在 MIT 许可证下授权的。 您可以根据 MIT 许可证的条款自由使用、修改和分发该软件。 有关详细信息，请参见 LICENSE 文件。