Yamaru Hardware Probe

Name: Yamaru Hardware Probe
Author: yamaru-eu

@yamaru-eu

Yamaru Hardware Probe について

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 compatibili

#hardware #diagnostic #monitoring #llm #performance #thermal #ram #gpu #vram #systeminformation #claude #mcp-server

基本情報

カテゴリ

AI とエージェント

トランスポート

stdio

公開者

yamaru-eu

投稿者

erz

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

Reads the hardware specifications of the local machine: CPU, RAM, motherboard and OS. Returns a structured JSON object.

Provides real-time system performance: CPU load, memory usage, and top processes.

Performs a deep scan for LLM inference optimization: GPU details, real memory bandwidth benchmark, ML runtimes (Ollama, Docker, WSL), and environment variables.

Returns the expert instructions and rules for optimizing LLM inference on this specific hardware. Call this to learn HOW to interpret analyze_inference_config results.

(BETA) Checks if a specific LLM model can run on this machine. Returns optimal quantization and estimated tokens per second. Requires remote API connection.

(BETA) Recommends the best LLM models that can run locally on this machine. Requires remote API connection.

Reports current memory pressure: total/used/free/available memory, swap usage, and top processes by RSS.

Reports per-disk health: type (NVMe/SSD/HDD), vendor, temperature, SMART status, and firmware.

Reports current CPU and GPU thermal and frequency state: temperature, utilization, and fan speed.

Detects running antivirus/EDR products and reads their exclusion rules. Checks dev hot paths coverage.

Monitors system metrics (CPU, RAM, Thermal) over a specified duration and returns statistical summary. Useful for diagnosing transient issues during high-load tasks.

概要

What is Yamaru Hardware Probe?

Open-source MCP server that gives LLM clients real hardware diagnostics from the machine they run on. It exposes 10 expert tools covering CPU, RAM, VRAM, thermals, storage health, and more — so AI assistants provide grounded, data-driven answers instead of generic responses. Built by the Yamaru project.

How to use Yamaru Hardware Probe?

Add the server configuration to your claude_desktop_config.json with the command npx -y @yamaru-eu/hardware-probe and restart Claude Desktop. The server then exposes 10 diagnostic tools queryable through any MCP client.

Key features of Yamaru Hardware Probe

Deep hardware inventory — CPU, RAM, GPU, motherboard, OS
Real-time performance monitoring with top processes
Thermal and power diagnostics with throttling detection
SMART storage health per-disk temperature and wear
Antivirus and EDR impact detection on dev paths
LLM compatibility prediction for quantization fit (BETA)

Use cases of Yamaru Hardware Probe

Diagnose PC slowness during local model inference
Check if your machine can run a specific LLM model
Verify antivirus is not scanning your models folder
Monitor system health over time for anomaly detection
Tune Ollama, CUDA, or Metal inference runtime settings

FAQ from Yamaru Hardware Probe

What makes this different from asking an LLM directly?

Instead of a generic “it depends on your configuration” response, the server lets the LLM read your actual CPU, RAM, VRAM, thermals, and storage health and give you a real, data-driven answer.

What runtime dependencies are required?

The server runs via npx with @yamaru-eu/hardware-probe. It is built on TypeScript, the MCP SDK, and the systeminformation library.

How does the server handle privacy?

The server is privacy-first — it automatically anonymizes unique hardware IDs before any remote call.

What features are in BETA status?

The LLM compatibility prediction tools (check_llm_compatibility, get_llm_recommendations, analyze_inference_config) are marked as BETA.

What license is the project under?

The project is licensed under Apache 2.0.

「AI とエージェント」の他のコンテンツ

🔎 GPT Researcher

assafelovic

An autonomous agent that conducts deep research on any data using any LLM providers

28.1K

Model Context Protocol for Unreal Engine

chongdashu

Enable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).

2.0K