Unraid MCP Server
Unraid MCP
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 계층 및 라이브 커버리지 테스트
도구
도구 색인
도구 | 목적 |
| 모든 작업을 위한 통합 action/subaction 라우터 |
| 이 참조 문서를 Markdown으로 반환 |
| WebSocket 구독 시스템의 전체 진단 덤프 |
| 스키마/디버그 작업을 위해 원시 GraphQL 구독 프로빙 |
unraid — 작업 그룹
모든 작업은 하나의 도구를 통해 수행됩니다. action을 선택한 다음 그 안에서 subaction을 선택하세요.
system — 18개 하위 작업
서버 정보, 메트릭, 네트워크 및 UPS.
하위 작업 | 설명 | 필수 매개변수 |
| OS, CPU, 메모리 레이아웃, 버전, 머신 ID | — |
| 어레이 상태, 용량, 디스크 상태 요약 | — |
| 액세스 URL, HTTP/HTTPS 포트, LAN/WAN IP | — |
| 라이선스 유형, 키 파일, 만료일 | — |
| 전체 Unraid 변수 세트 (시간대, 공유 등) | — |
| 실시간 CPU % 및 메모리 사용량 | — |
| 이름, 온라인 상태, 버전이 포함된 실행 중인 서비스 | — |
| 현재 UI 테마 이름 | — |
| 구성 유효성 및 오류 상태 | — |
| 부울 도달 가능성 확인 | — |
| 소유자 사용자 이름, 아바타, 프로필 URL | — |
| 통합 설정 키/값 맵 | — |
| 단일 호출 요약: 호스트 이름, 가동 시간, Unraid 버전, 어레이 상태 | — |
| LAN/WAN IP 및 URL이 포함된 모든 등록된 서버 | — |
| 플래시 드라이브 공급업체 및 제품 정보 | — |
| 배터리 및 전원 메트릭이 포함된 모든 UPS 장치 | — |
| 단일 UPS 장치 세부 정보 |
|
| UPS 데몬 구성 | — |
health — 4개 하위 작업
연결 및 시스템 상태 진단.
하위 작업 | 설명 | 필수 매개변수 |
| 포괄적인 상태: API 지연 시간, 어레이 상태, 경고, Docker 컨테이너 요약 | — |
| Unraid API를 핑하고 ms 단위의 지연 시간 반환 | — |
| 구독 시스템 상태, 오류 수, 재연결 상태 | — |
| 대화형 자격 증명 설정 (MCP 유도 지원) | — |
array — 13개 하위 작업
패리티 검사 및 어레이 디스크 작업. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 현재 패리티 검사 진행률, 속도, 오류 | — | — |
| 과거 패리티 검사 결과 | — | — |
| 패리티 검사 시작 |
| — |
| 실행 중인 패리티 검사 일시 중지 | — | — |
| 일시 중지된 패리티 검사 재개 | — | — |
| 실행 중인 패리티 검사 취소 | — | — |
| Unraid 어레이 시작 | — | — |
| Unraid 어레이 중지 |
| * |
| 어레이에 디스크 추가 |
| — |
| 어레이에서 디스크 제거 (어레이 중지 필요) |
| * |
| 어레이 디스크 마운트 |
| — |
| 어레이 디스크 마운트 해제 |
| — |
| 디스크의 I/O 통계 지우기 (되돌릴 수 없음) |
| * |
disk — 6개 하위 작업
공유, 물리적 디스크, 로그 파일 및 플래시 백업. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 크기, 할당 설정, LUKS 상태가 포함된 모든 사용자 공유 | — | — |
| 물리적 디스크 목록 (ID, 장치, 이름) | — | — |
| 단일 디스크: 일련번호, 크기, 온도 |
| — |
| 사용 가능한 로그 파일 목록 (이름, 경로, 크기, 수정됨) | — | — |
| 줄 범위를 지정하여 로그 파일 내용 읽기 |
| — |
| 플래시 드라이브를 원격으로 rclone 백업 시작 |
| * |
flash_backup 세부 정보: Unraid initiateFlashBackup GraphQL 뮤테이션을 호출하여 플래시 드라이브에서 구성된 rclone 원격으로 rclone 복사를 트리거합니다. 원격지의 대상이 존재하면 덮어씁니다. { status, jobId }를 반환합니다. 복원하려면: rclone을 사용하여 백업을 플래시 드라이브로 다시 복사하거나 개별 구성 파일을 추출하십시오. 먼저 rclone/create_remote를 통해 rclone 원격을 구성하십시오.
docker — 7개 하위 작업
컨테이너 수명 주기 및 네트워크 검사. 파괴적 하위 작업 없음.
하위 작업 | 설명 | 필수 매개변수 |
| 모든 컨테이너: ID, 이름, 이미지, 상태, 상태, autoStart | — |
| 전체 컨테이너 세부 정보: 포트, 마운트, 레이블, 네트워크 설정 |
|
| 컨테이너 시작 |
|
| 컨테이너 중지 |
|
| 컨테이너 중지 후 시작 (순차적으로 중지 + 시작) |
|
| 모든 Docker 네트워크: ID, 이름, 드라이버, 범위 | — |
| IPv6, 컨테이너, 옵션, 레이블이 포함된 단일 네트워크 |
|
컨테이너 식별자는 전체 ID, 짧은 ID 접두사, 정확한 이름 또는 모호하지 않은 이름 접두사를 허용합니다. 뮤테이션(start, stop, restart)은 정확한 이름 또는 전체 ID가 필요합니다.
vm — 9개 하위 작업
가상 머신 수명 주기. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 모든 VM: ID, 이름, 상태, UUID | — | — |
| 단일 VM 세부 정보 |
| — |
| VM 시작 |
| — |
| VM을 정상적으로 중지 |
| — |
| 실행 중인 VM 일시 중지 |
| — |
| 일시 중지된 VM 재개 |
| — |
| VM 재부팅 |
| — |
| VM 강제 전원 끄기 (데이터 손실 가능) |
| * |
| 정상적인 종료 없이 VM 강제 재설정 |
| * |
vm_id는 UUID, 접두사가 붙은 ID 또는 VM 이름을 허용합니다.
notification — 12개 하위 작업
시스템 알림 CRUD. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 중요도별 읽지 않음 및 보관함 수 (INFO/WARNING/ALERT) | — | — |
| 페이지가 매겨진 알림 목록 |
| — |
| 알림 생성 |
| — |
| 단일 알림 보관 |
| — |
| 보관된 알림을 읽지 않음으로 다시 이동 |
| — |
| 개요 수 다시 계산 | — | — |
| 모든 읽지 않은 알림 보관 | 선택 사항 | — |
| ID별 특정 알림 보관 |
| — |
| ID별 특정 알림 보관 해제 |
| — |
| 모든 보관된 알림을 읽지 않음으로 다시 이동 | 선택 사항 | — |
| 단일 알림 영구 삭제 |
| * |
| 모든 보관된 알림 영구 삭제 |
| * |
key — 7개 하위 작업
API 키 관리. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 역할 및 권한이 포함된 모든 API 키 | — | — |
| 단일 API 키 세부 정보 |
| — |
| API 키 생성 |
| — |
| 이름, 역할 또는 권한 업데이트 |
| — |
| API 키 삭제 (즉시 액세스 취소) |
| * |
| 기존 키에 역할 추가 |
| — |
| 기존 키에서 역할 제거 |
| — |
plugin — 3개 하위 작업
Unraid 플러그인 관리. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 버전 및 모듈 플래그가 포함된 모든 설치된 플러그인 | — | — |
| 이름으로 플러그인 설치 |
| — |
| 이름으로 플러그인 제거 (재설치 없이는 되돌릴 수 없음) |
| * |
rclone — 4개 하위 작업
클라우드 스토리지 원격 관리. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 유형 및 매개변수가 포함된 모든 구성된 rclone 원격 | — | — |
| 공급자 유형에 대한 구성 양식 스키마 | 선택 사항 | — |
| 새 rclone 원격 생성 |
| — |
| rclone 원격 구성 삭제 (원격 데이터는 삭제하지 않음) |
| * |
setting — 2개 하위 작업
시스템 설정. 파괴적 하위 작업은 *로 표시됨.
하위 작업 | 설명 | 필수 매개변수 | 파괴적 |
| 시스템 설정 업데이트 (JSON 키/값 입력) |
| — |
| UPS 모니터링 구성 덮어쓰기 |
| * |
customization — 5개 하위 작업
UI 테마 및 SSO 상태.
하위 작업 | 설명 | 필수 매개변수 |
| 전체 테마, 파트너 정보 및 활성화 코드 | — |
|
This server cannot be deployed
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Personal assistant MCP server with search, execute, packages, jobs, secrets, and integrations.
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceProvides 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.17ISC
- AlicenseAqualityDmaintenanceA 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.21MIT
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Unraid OS via Docker, system calls, and file system access for automating array, share, and container operations.-
- AlicenseNot gradedqualityDmaintenanceAn 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.2MIT