Skip to main content
Glama
dinglebear-ai

Unraid MCP Server

Unraid MCP

PyPI ghcr.io

GraphQL 기반의 Unraid용 MCP 서버입니다. 시스템 검사, 관리 작업, 실시간 원격 측정 및 명시적 확인이 필요한 파괴적 작업을 위한 통합 unraid 도구를 제공합니다.

개요

이 서버는 MCP 도구 호출을 HTTP 및 WebSocket을 통한 Unraid GraphQL 쿼리 및 뮤테이션으로 변환합니다. 모든 작업은 action + subaction으로 라우팅되는 단일 unraid 도구를 공유합니다. 실시간 원격 측정은 Unraid API에서 실시간 데이터를 스트리밍하는 WebSocket 구독을 사용합니다.

Related MCP server: unraid-code-mode-mcp

이 저장소의 구성 요소

  • unraid_mcp/ — 서버, GraphQL 클라이언트, WebSocket 구독, 구성 및 도구 핸들러

  • skills/unraid/ — 클라이언트용 스킬 문서

  • docs/ — 인증, 파괴적 작업 및 게시 참조

  • .claude-plugin/, .codex-plugin/, gemini-extension.json — 클라이언트 매니페스트

  • docker-compose.yaml, Dockerfile, entrypoint.sh — 컨테이너 배포

  • tests/ — 단위, 안전성, 스키마, HTTP 계층 및 라이브 커버리지 테스트

도구

도구 색인

도구

목적

unraid

모든 작업을 위한 통합 action/subaction 라우터

unraid_help

이 참조 문서를 Markdown으로 반환

diagnose_subscriptions

WebSocket 구독 시스템의 전체 진단 덤프

test_subscription_query

스키마/디버그 작업을 위해 원시 GraphQL 구독 프로빙

unraid — 작업 그룹

모든 작업은 하나의 도구를 통해 수행됩니다. action을 선택한 다음 그 안에서 subaction을 선택하세요.

system — 18개 하위 작업

서버 정보, 메트릭, 네트워크 및 UPS.

하위 작업

설명

필수 매개변수

overview

OS, CPU, 메모리 레이아웃, 버전, 머신 ID

array

어레이 상태, 용량, 디스크 상태 요약

network

액세스 URL, HTTP/HTTPS 포트, LAN/WAN IP

registration

라이선스 유형, 키 파일, 만료일

variables

전체 Unraid 변수 세트 (시간대, 공유 등)

metrics

실시간 CPU % 및 메모리 사용량

services

이름, 온라인 상태, 버전이 포함된 실행 중인 서비스

display

현재 UI 테마 이름

config

구성 유효성 및 오류 상태

online

부울 도달 가능성 확인

owner

소유자 사용자 이름, 아바타, 프로필 URL

settings

통합 설정 키/값 맵

server

단일 호출 요약: 호스트 이름, 가동 시간, Unraid 버전, 어레이 상태

servers

LAN/WAN IP 및 URL이 포함된 모든 등록된 서버

flash

플래시 드라이브 공급업체 및 제품 정보

ups_devices

배터리 및 전원 메트릭이 포함된 모든 UPS 장치

ups_device

단일 UPS 장치 세부 정보

device_id

ups_config

UPS 데몬 구성

health — 4개 하위 작업

연결 및 시스템 상태 진단.

하위 작업

설명

필수 매개변수

check

포괄적인 상태: API 지연 시간, 어레이 상태, 경고, Docker 컨테이너 요약

test_connection

Unraid API를 핑하고 ms 단위의 지연 시간 반환

diagnose

구독 시스템 상태, 오류 수, 재연결 상태

setup

대화형 자격 증명 설정 (MCP 유도 지원)

array — 13개 하위 작업

패리티 검사 및 어레이 디스크 작업. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

parity_status

현재 패리티 검사 진행률, 속도, 오류

parity_history

과거 패리티 검사 결과

parity_start

패리티 검사 시작

correct (bool)

parity_pause

실행 중인 패리티 검사 일시 중지

parity_resume

일시 중지된 패리티 검사 재개

parity_cancel

실행 중인 패리티 검사 취소

start_array

Unraid 어레이 시작

stop_array

Unraid 어레이 중지

confirm=True

*

add_disk

어레이에 디스크 추가

disk_id; 선택 사항 slot

remove_disk

어레이에서 디스크 제거 (어레이 중지 필요)

disk_id, confirm=True

*

mount_disk

어레이 디스크 마운트

disk_id

unmount_disk

어레이 디스크 마운트 해제

disk_id

clear_disk_stats

디스크의 I/O 통계 지우기 (되돌릴 수 없음)

disk_id, confirm=True

*

disk — 6개 하위 작업

공유, 물리적 디스크, 로그 파일 및 플래시 백업. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

shares

크기, 할당 설정, LUKS 상태가 포함된 모든 사용자 공유

disks

물리적 디스크 목록 (ID, 장치, 이름)

disk_details

단일 디스크: 일련번호, 크기, 온도

disk_id

log_files

사용 가능한 로그 파일 목록 (이름, 경로, 크기, 수정됨)

logs

줄 범위를 지정하여 로그 파일 내용 읽기

log_path; 선택 사항 tail_lines (기본값 100, 최대 10000)

flash_backup

플래시 드라이브를 원격으로 rclone 백업 시작

remote_name, source_path (/boot로 시작해야 함), destination_path, confirm=True

*

flash_backup 세부 정보: Unraid initiateFlashBackup GraphQL 뮤테이션을 호출하여 플래시 드라이브에서 구성된 rclone 원격으로 rclone 복사를 트리거합니다. 원격지의 대상이 존재하면 덮어씁니다. { status, jobId }를 반환합니다. 복원하려면: rclone을 사용하여 백업을 플래시 드라이브로 다시 복사하거나 개별 구성 파일을 추출하십시오. 먼저 rclone/create_remote를 통해 rclone 원격을 구성하십시오.

docker — 7개 하위 작업

컨테이너 수명 주기 및 네트워크 검사. 파괴적 하위 작업 없음.

하위 작업

설명

필수 매개변수

list

모든 컨테이너: ID, 이름, 이미지, 상태, 상태, autoStart

details

전체 컨테이너 세부 정보: 포트, 마운트, 레이블, 네트워크 설정

container_id

start

컨테이너 시작

container_id

stop

컨테이너 중지

container_id

restart

컨테이너 중지 후 시작 (순차적으로 중지 + 시작)

container_id

networks

모든 Docker 네트워크: ID, 이름, 드라이버, 범위

network_details

IPv6, 컨테이너, 옵션, 레이블이 포함된 단일 네트워크

network_id

컨테이너 식별자는 전체 ID, 짧은 ID 접두사, 정확한 이름 또는 모호하지 않은 이름 접두사를 허용합니다. 뮤테이션(start, stop, restart)은 정확한 이름 또는 전체 ID가 필요합니다.

vm — 9개 하위 작업

가상 머신 수명 주기. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

list

모든 VM: ID, 이름, 상태, UUID

details

단일 VM 세부 정보

vm_id

start

VM 시작

vm_id

stop

VM을 정상적으로 중지

vm_id

pause

실행 중인 VM 일시 중지

vm_id

resume

일시 중지된 VM 재개

vm_id

reboot

VM 재부팅

vm_id

force_stop

VM 강제 전원 끄기 (데이터 손실 가능)

vm_id, confirm=True

*

reset

정상적인 종료 없이 VM 강제 재설정

vm_id, confirm=True

*

vm_id는 UUID, 접두사가 붙은 ID 또는 VM 이름을 허용합니다.

notification — 12개 하위 작업

시스템 알림 CRUD. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

overview

중요도별 읽지 않음 및 보관함 수 (INFO/WARNING/ALERT)

list

페이지가 매겨진 알림 목록

list_type (UNREAD 또는 ARCHIVE, 기본값 UNREAD); 선택 사항 importance, offset, limit

create

알림 생성

title (≤200), subject (≤500), description (≤2000), importance (INFO/WARNING/ALERT)

archive

단일 알림 보관

notification_id

mark_unread

보관된 알림을 읽지 않음으로 다시 이동

notification_id

recalculate

개요 수 다시 계산

archive_all

모든 읽지 않은 알림 보관

선택 사항 importance (필터링용)

archive_many

ID별 특정 알림 보관

notification_ids (목록)

unarchive_many

ID별 특정 알림 보관 해제

notification_ids (목록)

unarchive_all

모든 보관된 알림을 읽지 않음으로 다시 이동

선택 사항 importance (필터링용)

delete

단일 알림 영구 삭제

notification_id, notification_type, confirm=True

*

delete_archived

모든 보관된 알림 영구 삭제

confirm=True

*

key — 7개 하위 작업

API 키 관리. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

list

역할 및 권한이 포함된 모든 API 키

get

단일 API 키 세부 정보

key_id

create

API 키 생성

name; 선택 사항 roles, permissions

update

이름, 역할 또는 권한 업데이트

key_id; 선택 사항 name, roles, permissions

delete

API 키 삭제 (즉시 액세스 취소)

key_id, confirm=True

*

add_role

기존 키에 역할 추가

key_id, roles (첫 번째 요소 사용)

remove_role

기존 키에서 역할 제거

key_id, roles (첫 번째 요소 사용)

plugin — 3개 하위 작업

Unraid 플러그인 관리. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

list

버전 및 모듈 플래그가 포함된 모든 설치된 플러그인

add

이름으로 플러그인 설치

names (목록); 선택 사항 bundled, restart

remove

이름으로 플러그인 제거 (재설치 없이는 되돌릴 수 없음)

names (목록), confirm=True

*

rclone — 4개 하위 작업

클라우드 스토리지 원격 관리. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

list_remotes

유형 및 매개변수가 포함된 모든 구성된 rclone 원격

config_form

공급자 유형에 대한 구성 양식 스키마

선택 사항 provider_type

create_remote

새 rclone 원격 생성

name, provider_type, config_data (문자열/숫자/부울 딕셔너리; 최대 50개 키)

delete_remote

rclone 원격 구성 삭제 (원격 데이터는 삭제하지 않음)

name, confirm=True

*

setting — 2개 하위 작업

시스템 설정. 파괴적 하위 작업은 *로 표시됨.

하위 작업

설명

필수 매개변수

파괴적

update

시스템 설정 업데이트 (JSON 키/값 입력)

settings_input (딕셔너리; 최대 100개 키, 스칼라 값만)

configure_ups

UPS 모니터링 구성 덮어쓰기

ups_config (딕셔너리), confirm=True

*

customization — 5개 하위 작업

UI 테마 및 SSO 상태.

하위 작업

설명

필수 매개변수

theme

전체 테마, 파트너 정보 및 활성화 코드

public_theme

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    Provides read-only server monitoring and diagnostic tools for AI assistants to manage Linux and Unraid systems via SSH. It enables natural language interactions for container management, storage health checks, and system log analysis while keeping credentials secure.
    17
    ISC
  • A
    license
    A
    quality
    D
    maintenance
    A code-mode MCP server for the Unraid 7.2+ GraphQL API that exposes search and execute tools, allowing LLM agents to introspect and call any GraphQL field via sandboxed JavaScript.
    2
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that enables AI assistants like Claude to manage Unraid servers through natural language. Install it from Community Applications and control your homelab from any MCP-compatible AI client.
    2
    MIT