English Français العربية

io.github.yamaru-eu/hardware-probe

Registre officiel IA et agents

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

Code source Documentation

Que pouvez-vous faire avec 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.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • REMOTE_API_URL URL of the remote recommendation API

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.yamaru-eu/hardware-probe ?

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

Comment installer io.github.yamaru-eu/hardware-probe ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hardware-probe -e 'REMOTE_API_URL=<REMOTE_API_URL>' -- npx -y @yamaru-eu/hardware-probe@1.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.yamaru-eu/hardware-probe ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

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

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient io.github.yamaru-eu/hardware-probe ?

Il est publié par yamaru-eu. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.