hardware-heartbeat 0.1.0

Add your description here

Hardware Heartbeat 硬件心跳监控 一个 Model Context Protocol (MCP) 服务器，提供实时硬件监控并用通俗易懂的语言生成状态报告。用普通人能理解的方式查看电脑的CPU、内存、磁盘、显卡和网络使用情况。

功能特点 🚀 实时CPU监控 - 查看处理器工作状态

🧠 内存使用跟踪 - 检查RAM使用情况和剩余空间

💾 磁盘空间分析 - 监控所有驱动器的存储情况

🎮 显卡状态报告 - 追踪显卡使用率和显存

🌐 网络活动监控 - 查看上传/下载速度

⚡ 快速状态概览 - 获取系统健康快照

📈 资源监控 - 随时间变化追踪资源使用

🗣️ 通俗易懂的描述 - 没有技术术语，只有清晰易懂的说明

安装 前提条件 Python 3.12 或更高版本

MCP服务器配置

json { "mcpServers": { "hardware_heartbeat": { "command": "uvx", "args": ["hardware_heartbeat"] } } }

使用示例 配置完成后，只需像平常聊天一样提问：

基础状态查询 "帮我看看电脑现在状态怎么样"

"检查一下我的系统状态"

"我的硬件现在什么情况？"

详细分析 "显示我的CPU使用情况"

"我用了多少内存？"

"检查我的磁盘空间"

"我的显卡现在忙吗？"

实时监控 "监控我的资源10秒钟"

"观察一下CPU和内存的变化"

可用工具 get_hardware_status() 获取完整的硬件状态报告，包含所有组件信息。

get_quick_status() 快速概览CPU、内存和显卡状态。

get_cpu_status() 详细的CPU处理器信息和使用情况。

get_memory_status() 内存使用情况和可用空间。

get_gpu_status() 显卡使用率、显存和温度信息。

get_disk_status() 所有磁盘分区的存储空间情况。

monitor_resources(duration=10, interval=2) 实时监控资源随时间的变化。

示例输出 text 💻 电脑硬件状态报告

🚀 CPU处理器 CPU正在正常工作，用了25%的力量 📊 使用率: 25% | 核心: 8核16线程 ⚡ 频率: 3600.0 MHz

🧠 内存 内存还很宽裕，用了8.2GB，还剩15.8GB空间 📊 使用率: 34% | 总量: 24.0GB

💾 磁盘存储 C:\ (C:) - 🟡 适中 空间还算够用，还剩45.2GB 📊 使用率: 78% | 总量: 256.0GB 系统要求 mcp[cli]>=1.15.0

psutil>=5.9.0

显卡支持 Hardware Heartbeat 自动检测和监控：

NVIDIA 显卡 (通过 nvidia-smi)

AMD/Intel 显卡 (基础信息)

集成显卡

要获得完整的显卡监控功能，请确保：

NVIDIA: 安装最新驱动并确保 nvidia-smi 在 PATH 中

Windows: 启用 WMIC

Linux: 安装合适的显卡驱动

故障排除 "无法获取显卡信息" 安装最新的显卡驱动

确保 nvidia-smi 在 PATH 中 (NVIDIA用户)

某些集成显卡可能只显示有限信息

"权限被拒绝"错误 使用适当的权限运行以访问硬件信息

某些磁盘分区可能无法访问

监控功能不工作 确保 psutil 正确安装 检查 Python 版本兼容性