Open Source MCP Server

AI-Powered Media Server
Management

Control your entire media library with natural language. A polished Desktop App with a built-in setup wizard, dashboard, and AI chat — or a one-command CLI for headless servers. Both drive the same stack of 30 MCP tools.

Native installer with a built-in wizard, dashboard, and AI chat.

DownloadbetaSee all platforms ↓
Get Started View on GitHub
Mediabox OS — Dashboard
Mediabox OS Dashboard
terminal
$ npx create-mediabox
🎬 Mediabox MCP — Setup Wizard
Configure your self-hosted media server stack
✔ Phase 1 — Wizard complete
✔ Phase 2 — Files generated
✔ Phase 3 — Docker containers started (8/8 ready)
✔ Phase 4 — Services auto-configured
Setup Complete!
Jellyfin https://media.example.com Ready
MCP Server https://media.example.com/mcp Ready
Sonarr https://sonarr.media.example.com Ready
Next: Add indexers in Prowlarr → https://prowlarr.media.example.com
Mediabox OS — the desktop app

Your entire media stack, one app

Mediabox OS deploys, monitors and lets you drive Jellyfin, Sonarr, Radarr, Prowlarr, qBittorrent, PyLoad and FlareSolverr — without ever opening five web UIs. The MCP server runs as a bundled sidecar, so there is nothing extra to install.

Mediabox OS — Dashboard
Stack overview

Nine services, one live view

Now-playing pulled from Jellyfin, server health, downloads merged from qBittorrent and PyLoad, library counts straight from your *arr stack — all rolled up on a single dashboard. Nothing here is a mockup; it talks to the real services.

Click any thumbnail to switch · click the main image to expand

v2.2 beta · Desktop App

Download Mediabox OS

Native Desktop App with a built-in setup wizard, dashboard, AI chat, and live container logs. Bundles the MCP server as a sidecar — no extra install needed.

Windows

x64 · MSI installer

Works on Windows 10 / 11 (64-bit). Use the .msi for unattended installs or the .exe (NSIS) for a guided installer.

Download .msi · ~50 MB Or download the .exe (NSIS) installer

macOS

Universal · Apple Silicon + Intel

One .dmg that runs natively on M-series and Intel Macs. Drag the app to Applications.

Download .dmg · ~85 MB

Linux · Debian/Ubuntu

amd64 · .deb

Install with `sudo dpkg -i Mediabox.OS_*.deb`. AppImage support is on the roadmap.

Download .deb · ~55 MB

Beta builds are unsigned. Windows SmartScreen and macOS Gatekeeper will warn on first launch — open via right-click → Open on macOS, or "More info → Run anyway" on Windows.

All releases on GitHub · v2.2.0-beta.0

Everything you need

A complete self-hosted media stack, orchestrated by AI

Docker Stack

Jellyfin, Sonarr, Radarr, qBittorrent, Prowlarr, PyLoad, FlareSolverr, and more — all orchestrated with Docker Compose.

30 AI Tools

Search, download, organize, and maintain your media library entirely through natural language conversations.

One-Command Setup

Run npx create-mediabox and the interactive wizard handles everything: config, Docker, and service auto-configuration.

Telegram Bot

Manage your server from anywhere with the optional Telegram integration powered by LLM providers.

3 Deploy Modes

Local network, VPS with Caddy reverse proxy and auto-HTTPS, or Cloudflare Tunnel for home servers behind NAT.

Protected Access

OAuth-protected MCP access, server-issued confirmation tokens, path and URL sandboxing, browser origin allowlisting, and Docker network isolation.

Architecture

A unified AI layer connecting all your media services

AI Client
Claude / ChatGPT / Telegram
MCP Server
30 MCP Tools
Express + OAuth2 + Streamable HTTP
Jellyfin
:8096
Sonarr
:8989
Radarr
:7878
Prowlarr
:9696
qBittorrent
:8085
PyLoad
:8000
FlareSolverr
:8191
MCP Server
:3000
Shared Media Volume
/data/movies · /data/tv · /data/anime · /data/music

Powerful Tools

30 tools across 6 categories to manage every aspect of your media server

30 tools
server_status

Server info, disk usage, library stats, active sessions

activity_log

Recent activity: who watched what, logins, library changes

search_media

Search or list content with pagination and type filtering

show_details

TV show details with seasons and episodes breakdown

Deploy Anywhere

Choose the deployment mode that fits your setup

Local

Direct port access on your home network. Simplest setup for personal use.

Endpoint
8096, 8989, 7878...
Best for: Home network

VPS + Caddy

Automatic HTTPS with Let's Encrypt. Each service gets its own subdomain.

Endpoint
jellyfin.domain.com
Best for: Cloud servers

Cloudflare Tunnel

No port forwarding needed. Secure access through Cloudflare's network.

Endpoint
Cloudflare Network
Best for: Home behind NAT

Up and Running in 3 Steps

From zero to a fully configured media server in minutes

1

Run the installer

One command bootstraps everything

bash 
npx create-mediabox
2

Answer the wizard

Choose deployment mode, set media paths, credentials for qBittorrent and Jellyfin, and optionally enable Telegram bot with your LLM API key

? Where are you installing? VPS / Cloud server
? Base domain: media.example.com
? Email for Let's Encrypt: you@email.com
? Timezone: America/Bogota (detected)
? Movies path: ./media/movies
? qBittorrent password: ••••••••
? Jellyfin admin username: admin
? Jellyfin admin password: ••••••••
? Enable Telegram bot? No
? Enable Bazarr? No
3

Connect your AI

Add the MCP server to Claude Desktop or any MCP client

json 
{
  "mcpServers": {
    "mediabox": {
      "url": "https://your-domain.com/mcp"
    }
  }
}
30
MCP Tools
7+
Docker Services
3
Deploy Modes
1
Command Setup

Ready to automate your media server?

Join the open-source community building the future of AI-powered media management.

Get Started Star on GitHub