系统资源监控服务

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

  • by abhinav7895
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 abhinav7895/system-mcp

使用说明

系统资源监视器MCP服务器

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

工具

  • get_cpuusage

    • 以百分比形式检索当前CPU负载,包括总体和每个内核的使用情况。
    • 输入:无
    • 输出:文本(例如。, CPU Load: 12.34% (Cores: 10.50, 15.20, 8.90, 14.60%))
  • get_memory_用法

    • 报告总内存、已用内存和可用内存(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))
  • 获取电池状态

    • 提供电池充电百分比、充电状态和剩余时间(如适用)。
    • 输入:无
    • 输出:文本(例如。, 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

第二步:构建项目

编译TypeScript代码:

npm run build

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

步骤3:配置Claude桌面

  1. 下载克劳德桌面 这里.
  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:高级定制

  • 互联网速度测试:修改 testUrls 在……里面 index.ts 使用不同的下载源或进行调整 uploadSizeBytes (默认80KB)用于上传测试。
  • 日志记录:控制台日志提供详细的测试输出;通过删除在生产中禁用它们 console.log 声明。

故障排除

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

许可证

此MCP服务器根据MIT许可证获得许可。您可以根据MIT许可证的条款自由使用、修改和分发软件。请参阅 LICENSE 文件以获取详细信息。