Claude ROCm GPU 모니터

Linux용 Claude Desktop을 위한 읽기 전용 AMD GPU 모니터링 도구입니다. Claude가 "학습 실행이 정상인가요?", "GPU 온도가 얼마나 되나요?", "VRAM이 얼마나 남았나요?", "어떤 프로세스가 카드를 사용 중인가요?" 와 같은 질문에 답할 수 있게 해줍니다. 이 모든 작업은 프로세스 종료, 클럭 변경 또는 실행 중인 워크로드에 영향을 주는 기능 없이 수행됩니다.

이 도구는 rocm-smi(및 선택적으로 amdgpu_top)를 호출하여 5가지의 엄격한 읽기 전용 도구를 제공합니다. 프로세스 종료, 클럭/전력 오버라이드, 팬 제어 기능은 없습니다. 그러한 기능이 필요하다면 gpu-kill과 같은 도구를 사용하세요.

요구 사항

• Linux 및 AMD GPU (RDNA2/3/4 소비자용 카드 — RX 6000/7000/9000, R9700 — 및 CDNA 데이터 센터 카드).

• amdgpu 커널 모듈 로드됨 (최신 Ubuntu/Debian/Fedora에서 기본 제공).

• rocm-smi 설치됨:

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

일부 메트릭(클럭, 전력, 상세 온도)은 최신 ROCm 릴리스가 필요합니다. 카드나 드라이버에서 메트릭을 지원하지 않는 경우, 도구는 실패하는 대신 null을 반환합니다.

Related MCP server: System Monitor MCP Server

설치 (Claude Desktop)

1. Releases 페이지에서 최신 ROCm.mcpb를 다운로드합니다.

2. Claude Desktop에서 **설정 → 확장 프로그램(Extensions)**을 엽니다.

3. 하단의 **확장 프로그램 개발자(Extension Developer)**로 스크롤하여 **확장 프로그램 설치(Install Extension)**를 클릭하고 .mcpb 파일을 선택합니다.

4. 확장 프로그램을 활성화합니다. Claude의 도구 선택기에서 rocm-gpu-monitor: 접두사가 붙은 도구들이 나타납니다.

도구

모든 도구는 MCP readOnlyHint: true / destructiveHint: false / openWorldHint: false 주석을 포함합니다.

예시 프롬프트

"학습 실행이 안정적인가요? 20초 동안 GPU를 모니터링해줘."

"현재 PyTorch 프로세스가 VRAM을 얼마나 사용하고 있나요?"

"GPU가 열 스로틀링 중인가요? 정션 온도가 어떻게 되나요?"

"어떤 ROCm 버전이 설치되어 있고 드라이버가 로드되었나요?"

개인정보 보호정책

이 확장 프로그램은 전적으로 로컬 머신에서 실행되며, 항상 읽기 전용으로 다음 프로그램만 호출합니다:

• rocm-smi — 장치 메트릭을 위해 AMD 커널 드라이버를 쿼리합니다.

• amdgpu_top (설치된 경우) — 더 풍부한 메트릭을 제공합니다.

• dpkg -l — 이름/버전별로 설치된 ROCm 관련 패키지를 나열합니다.

• lsmod — amdgpu 커널 모듈이 로드되었는지 확인합니다.

• which — 시작 시 위 바이너리들의 위치를 찾습니다.

데이터는 머신 밖으로 나가지 않습니다. 이 확장 프로그램은 네트워크 I/O를 수행하지 않고, 소켓을 열지 않으며, 표준 프로세스 stdout/stderr(Claude Desktop 로그 디렉토리에 캡처됨) 외에 파일을 쓰지 않습니다. GPU 상태(클럭, 전력, 팬)를 수정하거나, 프로세스를 종료하거나, 실행 중인 워크로드에 영향을 줄 수 없습니다. 모든 도구는 엄격하게 읽기 전용입니다.

Claude가 볼 수 있는 정보에는 GPU 모델 및 펌웨어 버전, 현재 VRAM 사용량, 온도/클럭/전력 수치, GPU를 사용하는 실행 중인 프로세스 PID 및 VRAM 사용량, 설치된 ROCm 관련 패키지 목록이 포함됩니다. 이러한 정보 중 민감한 내용(예: 공유 머신에서 실행 중인 프로세스 PID 목록)이 있다고 판단되면 이 확장 프로그램을 활성화하지 마십시오.

문제 해결

"rocm-smi is not installed" — 설치하세요 (sudo apt install rocm-smi). Debian 계열이 아닌 배포판을 사용하는 경우 AMD의 ROCm 설치 지침을 따르세요.

새 GPU에서 많은 필드가 null로 반환됨 — 일부 메트릭(클럭, 전력, 온도)은 rocm-smi를 통해 노출되는 펌웨어 지원에 따라 다릅니다. 매우 새로운 카드(예: RDNA4/R9700)의 경우, -a --json은 데이터를 반환하더라도 개별 rocm-smi --showclocks/--showpower는 "No JSON data to report"라고 보고할 수 있습니다. 이 확장 프로그램은 커버리지를 극대화하기 위해 -a --json을 기본 소스로 사용합니다. 특정 필드가 카드에서 지원되지 않는 경우 오류 대신 null이 반환됩니다.

권한 오류 — rocm-smi는 일반적으로 루트 권한 없이 실행됩니다. 권한 오류가 발생하면 Claude Desktop을 실행하는 사용자가 render 및 video 그룹에 속해 있는지 확인하세요:

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

개발

이 서버는 npm 의존성이 없는 약 300줄의 Node.js 스크립트입니다. .mcpb를 다시 빌드하려면:

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

라이선스

MIT. LICENSE를 참조하세요.

관련 프로젝트

• claude-terminal-mcp — 셸, 파일 시스템 및 백그라운드 작업.

• claude-linux-mcp — X11 데스크톱 제어(스크린샷, 마우스, 키보드, 창, 클립보드).