Open Source MCP Server

AI-Powered Media Server
Management

Control your entire media library with natural language. One command to deploy Jellyfin, Sonarr, Radarr, and more — a complete self-hosted stack fully managed by AI through 25 MCP tools.

Get started in seconds

$ npx create-mediabox
Get Started View on GitHub
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

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.

25 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.

OAuth2 Security

Secure MCP server with OAuth2 authentication, API key management, and Docker network isolation.

Architecture

A unified AI layer connecting all your media services

AI Client
Claude / ChatGPT / Telegram
MCP Server
25 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

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

25 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: [email protected]
? 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"
    }
  }
}
25
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