English Français العربية

io.github.yamaru-eu/hardware-probe

Official registry AI and agents

Hardware probe for performance diagnostics, thermal monitoring, and LLM optimization.

Source code Documentation

What can you do with io.github.yamaru-eu/hardware-probe?

  • 🔍 Deep Hardware Inventory: Comprehensive analysis of CPU, RAM, GPU (VRAM/Bandwidth), Storage, and OS topology.
  • ⚡ Real-time Performance Monitoring: Live tracking of system load and identification of resource-hogging processes.
  • 🧊 Thermal & Power Diagnostics: Detects thermal throttling and frequency clipping to resolve unexpected slowness.
  • 🤖 AI/LLM Optimization: Specialized tools for predicting LLM performance, calculating quantization fit, and optimizing runtimes (Ollama, CUDA, Metal).
  • 🛡️ Privacy-First: Automatic anonymization of unique hardware identifiers before any remote transmission.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @yamaru-eu/hardware-probe
Claude Code 
claude mcp add hardware-probe -e 'REMOTE_API_URL=<REMOTE_API_URL>' -- npx -y @yamaru-eu/hardware-probe@1.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hardware-probe": {
            "command": "npx",
            "args": [
                "-y",
                "@yamaru-eu/hardware-probe@1.1.2"
            ],
            "env": {
                "REMOTE_API_URL": "<REMOTE_API_URL>"
            }
        }
    }
}

Environment variables

  • REMOTE_API_URL URL of the remote recommendation API

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Yamaru Hardware Probe (MCP)
  2. Key Features
  3. Installation
  4. Available Tools
  5. Skills Integration
  6. Development
  7. License

Yamaru Hardware Probe (MCP)

Expert system hardware probe and performance diagnostic engine for AI, Gaming, and High-Performance workflows. This is a Model Context Protocol (MCP) server that provides deep system insights beyond simple specifications.

Key Features

  • 🔍 Deep Hardware Inventory: Comprehensive analysis of CPU, RAM, GPU (VRAM/Bandwidth), Storage, and OS topology.
  • ⚡ Real-time Performance Monitoring: Live tracking of system load and identification of resource-hogging processes.
  • 🧊 Thermal & Power Diagnostics: Detects thermal throttling and frequency clipping to resolve unexpected slowness.
  • 🤖 AI/LLM Optimization: Specialized tools for predicting LLM performance, calculating quantization fit, and optimizing runtimes (Ollama, CUDA, Metal).
  • 🛡️ Privacy-First: Automatic anonymization of unique hardware identifiers before any remote transmission.

Installation

For Gemini CLI Users
gemini extension install @yamaru-eu/hardware-probe
For Manual MCP Setup

Add this to your MCP settings file (e.g., npx-config.json or claude_desktop_config.json):

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

Available Tools

  • analyze_local_system: Full hardware inventory.
  • analyze_performance: Real-time performance metrics and top processes.
  • analyze_ram_pressure: Detailed memory pressure and RSS analysis for deep RAM troubleshooting.
  • check_storage_health: Disk SMART health, firmware, and I/O bottleneck analysis.
  • thermal_profile: Real-time CPU/GPU thermal states, fan speeds, and frequency throttling detection.
  • diagnose_antivirus_impact: Detects EDR/Antivirus conflicts and exclusion coverage on dev paths.
  • monitor_system_health: Statistical health report (CPU load, RAM usage, temperature) with min/max/avg over a configurable time window (up to 10 minutes).
  • check_llm_compatibility (BETA): Predicts performance for a specific LLM model via remote API.
  • get_llm_recommendations (BETA): Recommends the best local models via remote API.
  • analyze_inference_config: Deep-dive into AI runtimes and environment variables.

Skills Integration

When used with Gemini CLI, this extension provides the following expert skills:

  • hardware-performance-expert: Global protocol for system health and troubleshooting.
  • local-inference-optimizer: Specialized logic for fine-tuning local LLM runs.

Development

npm install        # Install dependencies
npm run build      # Compile TypeScript → dist/
npm run test       # Run test suite
npm run inspector  # Test tools in the MCP Inspector

License

Apache 2.0 - Part of the Yamaru Project.

Frequently asked questions

What is io.github.yamaru-eu/hardware-probe?

Hardware probe for performance diagnostics, thermal monitoring, and LLM optimization.

How do I install io.github.yamaru-eu/hardware-probe?

It runs on your machine. In Claude Code: claude mcp add hardware-probe -e 'REMOTE_API_URL=<REMOTE_API_URL>' -- npx -y @yamaru-eu/hardware-probe@1.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.yamaru-eu/hardware-probe need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.yamaru-eu/hardware-probe open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains io.github.yamaru-eu/hardware-probe?

It is published by yamaru-eu. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.