Yamaru Hardware Probe

Created By
yamaru-eu2 months ago
Yamaru Hardware Probe gives Claude Desktop and other MCP clients real visibility into your machine. 10 expert tools: full hardware inventory, real-time performance & thermal monitoring, RAM pressure analysis, SMART storage health, antivirus impact diagnostics, and LLM compatibility checks (VRAM fit, quantization prediction). Perfect for AI engineers, developers,vibe coder, gamers, and creators who want grounded answers instead of "it depends on your config". Apache 2.0, privacy-first (auto-anonymization), npm-installable.
Overview

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

ToolPurpose
analyze_local_systemFull CPU/RAM/GPU/MB/OS inventory
analyze_performanceReal-time load + top processes
analyze_ram_pressureMemory + swap + top 10 by RSS
check_storage_healthSMART status, temperature, type
thermal_profileCPU/GPU temps, fans, throttling
diagnose_antivirus_impactAV/EDR conflicts on dev paths
monitor_system_healthMin/max/avg over a duration
check_llm_compatibilityVRAM fit prediction (BETA)
get_llm_recommendationsBest local models for your rig (BETA)
analyze_inference_configOllama/CUDA/Metal runtime tuning

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.

Server Config

{
  "mcpServers": {
    "yamaru-probe": {
      "command": "npx",
      "args": [
        "-y",
        "@yamaru-eu/hardware-probe"
      ]
    }
  }
}
Project Info
Created At
2 months ago
Updated At
2 months ago
Author Name
yamaru-eu
Star
-
Language
-
License
-
Category

Recommend Servers

View All