Unraid MCP Server
Unraid MCP
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 계층 및 라이브 커버리지 테스트
도구
도구 색인
도구 | 목적 |
| 모든 작업을 위한 통합 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…
Connect AI assistants to your GitHub-hosted Obsidian vault to seamlessly access, search, and analy…
Official Fibery MCP server: query and update your workspace from any AI client via OAuth.
Related MCP Servers
- AlicenseAqualityCmaintenanceA 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.3MIT
- AlicenseBqualityBmaintenanceA 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.88MIT