Skip to main content
Glama
Unraid MCP Server

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-mcp-server

이 저장소의 구성 요소

  • 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
    A
    quality
    C
    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.
    3
    MIT
  • A
    license
    B
    quality
    B
    maintenance
    A Model Context Protocol server that enables AI clients to inspect and manage an Unraid server via its GraphQL API, with read-only defaults and optional enabled mutations.
    88
    MIT