README

Unraid MCP Server Deployment Configuration

This file contains the docker run command or docker-compose configuration needed to deploy the MCP server on an Unraid host.

Prerequisites

The host must have Docker installed (standard for Unraid).
The container must run in privileged mode to interact with host system calls and devices.

Docker Run Command

docker run -d \
  --name unraid-mcp-server \
  --privileged \
  --restart unless-stopped \
  -p 8000:8000 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /usr/bin:/usr/bin \
  -v /usr/sbin:/usr/sbin \
  -v /mnt:/mnt \
  -v /proc:/proc \
  -v /sys:/sys \
  -v $(pwd)/.env:/app/.env \
  unraid-mcp-server:latest

Volume Mappings Explained

Host Path	Container Path	Purpose
`/var/run/docker.sock`	`/var/run/docker.sock`	Allows managing host Docker containers.
`/usr/bin`	`/usr/bin`	Provides access to Unraid management binaries.
`/usr/sbin`	`/usr/sbin`	Provides access to administrative host binaries.
`/mnt`	`/mnt`	Access to the Unraid user shares and array disks.
`/proc`	`/proc`	Access to kernel/process information.
`/sys`	`/sys`	Access to hardware/kernel sysfs.
`$(pwd)/.env`	`/app/.env`	Passes environment variables from the host.

Docker Compose Configuration

services:
  mcp-server:
    build: .
    container_name: unraid-mcp-server
    privileged: true
    restart: unless-stopped
    ports:
      - "8000:8000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /usr/bin:/usr/bin
      - /usr/sbin:/usr/sbin
      - /mnt:/mnt
      - /proc:/proc
      - /sys:/sys
      - ./.env:/app/.env

unraid-mcp-server

README

Unraid MCP Server Deployment Configuration

Prerequisites

Docker Run Command

Volume Mappings Explained

Docker Compose Configuration

Recommended Servers