Claude ROCm GPU-Monitor

Schreibgeschützte AMD-GPU-Überwachung für Claude Desktop unter Linux. Ermöglicht es Claude, Fragen zu beantworten wie „Läuft mein Trainingslauf stabil?“, „Wie heiß ist die GPU?“, „Wie viel VRAM ist noch frei?“ und „Welcher Prozess nutzt die Karte?“ – alles ohne die Möglichkeit, Prozesse zu beenden, Taktraten zu ändern oder laufende Workloads anderweitig zu stören.

Das Tool greift auf rocm-smi (und optional amdgpu_top) zu und stellt fünf streng schreibgeschützte Werkzeuge bereit. Kein Beenden von Prozessen, keine Takt-/Strom-Überschreibungen, keine Lüftersteuerung. Verwenden Sie dafür Tools wie gpu-kill.

Anforderungen

• Linux mit einer AMD-GPU (RDNA2/3/4 Consumer-Karten – RX 6000/7000/9000, R9700 – und CDNA-Rechenzentrumskarten).

• amdgpu Kernel-Modul geladen (Standard bei modernem Ubuntu/Debian/Fedora).

• rocm-smi installiert:

  sudo apt install rocm-smi            # minimal
  # or a full ROCm stack:
  # https://rocm.docs.amd.com/projects/install-on-linux/

Einige Metriken (Taktraten, Stromverbrauch, detaillierte Temperaturen) erfordern neuere ROCm-Versionen. Wenn eine Metrik von Ihrer Karte/Ihrem Treiber nicht unterstützt wird, gibt das Tool null zurück, anstatt einen Fehler zu verursachen.

Related MCP server: System Monitor MCP Server

Installation (Claude Desktop)

1. Laden Sie die neueste ROCm.mcpb von der Releases-Seite herunter.

2. Öffnen Sie in Claude Desktop Einstellungen → Erweiterungen.

3. Scrollen Sie nach unten zu Erweiterungsentwickler, klicken Sie auf Erweiterung installieren und wählen Sie die .mcpb-Datei aus.

4. Aktivieren Sie die Erweiterung. Die Tools erscheinen mit dem Präfix rocm-gpu-monitor: in Claudes Tool-Auswahl.

Tools

Alle Tools enthalten die MCP-Annotationen readOnlyHint: true / destructiveHint: false / openWorldHint: false.

Beispiel-Prompts

„Läuft mein Trainingslauf stabil? Überwache die GPU für 20 Sekunden.“

„Wie viel VRAM verbraucht mein aktueller PyTorch-Prozess?“

„Drosselt die GPU aufgrund von Hitze? Wie hoch ist die Junction-Temperatur?“

„Welche ROCm-Version ist installiert und ist der Treiber geladen?“

Datenschutzrichtlinie

Diese Erweiterung läuft vollständig auf Ihrem lokalen Rechner und greift nur auf die folgenden Programme zu, immer im schreibgeschützten Modus:

• rocm-smi – fragt den AMD-Kernel-Treiber nach Gerätemetriken ab.

• amdgpu_top (falls installiert) – optionale, detailliertere Metriken.

• dpkg -l – listet installierte ROCm-bezogene Pakete nach Name/Version auf.

• lsmod – prüft, ob das amdgpu-Kernel-Modul geladen ist.

• which – lokalisiert die oben genannten Binärdateien beim Start.

Es verlassen keine Daten Ihren Rechner. Diese Erweiterung führt keine Netzwerk-I/O durch, öffnet keine Sockets und schreibt keine Dateien außerhalb des Standard-Prozess-stdout/stderr (erfasst durch das Protokollverzeichnis von Claude Desktop). Sie kann den GPU-Zustand nicht ändern (Taktraten, Strom, Lüfter), keine Prozesse beenden oder laufende Workloads anderweitig stören – jedes Tool ist streng schreibgeschützt.

Die für Claude sichtbaren Informationen umfassen GPU-Modell und Firmware-Versionen, aktuellen VRAM-Verbrauch, Temperatur-/Takt-/Strom-Messwerte, PIDs der laufenden GPU-nutzenden Prozesse und deren VRAM-Verbrauch sowie eine Liste der installierten ROCm-bezogenen Pakete. Wenn Sie dies als sensibel erachten (z. B. die Liste der laufenden Prozess-PIDs auf einem gemeinsam genutzten Rechner), aktivieren Sie diese Erweiterung nicht.

Fehlerbehebung

„rocm-smi is not installed“ – installieren Sie es (sudo apt install rocm-smi). Wenn Sie eine Nicht-Debian-Distribution verwenden, folgen Sie den ROCm-Installationsanweisungen von AMD.

Viele Felder werden auf einer neuen GPU als null zurückgegeben – einige Metriken (Taktraten, Strom, Temperatur) hängen von der Firmware-Unterstützung ab, die über rocm-smi bereitgestellt wird. Bei sehr neuen Karten (z. B. RDNA4/R9700) melden einzelne rocm-smi --showclocks/--showpower-Befehle möglicherweise „No JSON data to report“, obwohl -a --json die Daten zurückgibt. Diese Erweiterung verwendet -a --json als primäre Quelle, um die Abdeckung zu maximieren. Wenn ein bestimmtes Feld auf Ihrer Karte nicht unterstützt wird, wird es als null statt als Fehler angezeigt.

Berechtigungsfehler – rocm-smi läuft normalerweise ohne Root-Rechte. Wenn Sie Berechtigungsfehler sehen, prüfen Sie, ob der Benutzer, der Claude Desktop ausführt, Mitglied der Gruppen render und video ist:

sudo usermod -aG render,video $USER
# log out and back in

Entwicklung

Der Server ist ein einzelnes, ca. 300 Zeilen langes Node.js-Skript ohne npm-Abhängigkeiten. Um die .mcpb neu zu erstellen:

cd bundle-source
zip -j ../ROCm.mcpb manifest.json package.json server.js README.md LICENSE icon.png

Lizenz

MIT. Siehe LICENSE.

Verwandte Projekte

• claude-terminal-mcp – Shell, Dateisystem und Hintergrundjobs.

• claude-linux-mcp – X11-Desktop-Steuerung (Screenshot, Maus, Tastatur, Fenster, Zwischenablage).