Yamaru Hardware Probe

Give Claude (and any MCP client) real eyes on your machine.

Yamaru Hardware Probe is an open-source MCP server that exposes 10 expert diagnostic tools to your LLM client — so you finally get grounded answers instead of "it depends on your configuration".

Why this exists

LLMs are great at reasoning, but blind to the box they run on. Ask Claude "can my PC run Llama 3 70B in Q4_K_M?" and you'll get a generic answer. With this MCP server, Claude reads your actual CPU, RAM, VRAM, thermals, and storage health — then gives you a real, chiffré answer.

Features

• 🔍 Deep Hardware Inventory — CPU, RAM slots, GPU/VRAM, motherboard, OS topology
• ⚡ Real-time Performance — live CPU/memory load + top processes by RSS
• 🧊 Thermal & Power Diagnostics — detects throttling, fan RPM, frequency clipping
• 💾 SMART Storage Health — per-disk temperature, wear level, I/O bottlenecks
• 🛡️ Antivirus / EDR Impact — detects exclusion gaps on dev hot paths
• 🤖 LLM Compatibility (BETA) — predicts quantization fit and VRAM requirements
• 📊 Time-bound monitoring — min/max/avg health reports over a duration
• 🔒 Privacy-first — automatic anonymization of unique hardware IDs before any remote call

Quick Install

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "yamaru-probe": {
      "command": "npx",
      "args": ["-y", "@yamaru-eu/hardware-probe"]
    }
  }
}

Restart Claude Desktop. Done.

Available Tools

Example Prompts

• "Why is my PC slow during local inference? Diagnose."
• "Can I run Llama 3 70B Q4_K_M on this machine?"
• "Check if my antivirus is scanning my models folder."
• "Monitor my system health for 60 seconds and report anomalies."

Stack & License

TypeScript · MCP SDK · systeminformation · Apache 2.0 Built by the Yamaru project.

• 📦 npm: @yamaru-eu/hardware-probe
• 🐙 GitHub: yamaru-eu/hardware-probe
• 🐛 Issues & feedback welcome