media-mcp

MCP server for media stack management — movies/TV (Jellyseerr, Radarr, Sonarr, Jellyfin), audiobooks/ebooks (Prowlarr → qBittorrent → Audiobookshelf), and music (Prowlarr/Bandcamp → qBittorrent → Navidrome). Shared by Sebastian, Max, and Claude Code.

Where it runs

• Host: the bot host

• Path: ~/projects/media-mcp/

• Transport: stdio via uvx (MCP) + HTTP :8097 (webhook receiver)

• Deploy: CI on push (git pull + restart of the webhook service)

• Media stack: a media host running Jellyseerr/Radarr/Sonarr/Prowlarr/qBittorrent/Jellyfin

Related MCP server: Mediabox MCP

Architecture

media host                      bot host                    dev machine
┌──────────────┐                ┌────────────────┐           ┌──────────────┐
│ Jellyseerr   │◄──HTTP──┐     │  server.py     │           │ media-mcp    │
│ Radarr       │◄────────┤     │  (FastMCP)     │           │ (full mode)  │
│ Sonarr       │◄────────┤     │  MODE=safe|full│           └──────────────┘
│ Prowlarr     │◄────────┤     └──┬──────────┬──┘
│ qBittorrent  │◄────────┤        │          │
│ Jellyfin     │◄────────┘     ┌──▼──┐  ┌───▼────┐
└──────────────┘               │ Max │  │Sebast. │
         │                     │safe │  │ full   │
         │  webhook            └─────┘  └────────┘
         └─────────────────►webhook_receiver.py :8097
                               → Telegram push

Modes

Set via MEDIA_MCP_MODE env variable.

Tools

SAFE (11 tools)

Movies / TV:

Audiobooks / ebooks (Prowlarr → qBittorrent → Audiobookshelf):

FULL (additional 23 tools)

Radarr: radarr_queue, radarr_search_releases, radarr_grab_release, radarr_delete_movie Sonarr: sonarr_queue, sonarr_search_releases, sonarr_grab_release, sonarr_delete_series qBit: qbit_list_torrents, qbit_pause, qbit_resume, qbit_delete Prowlarr: prowlarr_indexer_status, prowlarr_test_indexer Jellyfin: jellyfin_scan_library, jellyfin_refresh_item Books: book_cancel

Music (Prowlarr/Bandcamp → qBittorrent → Navidrome):

See discovery/ for the batch taste-based music-collection top-up that drives music_*.

Destructive tools (*_delete, *_grab, *_cancel) require confirm=True. Default is dry-run preview.

Run

# SAFE mode
MEDIA_MCP_MODE=safe JELLYSEERR_URL=http://localhost:5055 JELLYSEERR_API_KEY=... \
  uvx --with mcp --with requests python server.py

# FULL mode
MEDIA_MCP_MODE=full JELLYSEERR_URL=... RADARR_URL=... RADARR_API_KEY=... \
  uvx --with mcp --with requests python server.py

Environment Variables

Books add ABS_URL / ABS_API_KEY (Audiobookshelf); music adds NAVIDROME_URL / NAVIDROME_USER / NAVIDROME_PASS. See .env.example for the full list (importer paths, Telegram notifications, webhook, discovery tuning).

Stack

• Python 3.11+

• FastMCP (mcp.server.fastmcp)

• requests

• No Docker — runs directly via uvx

Status

Movies/TV, audiobooks/ebooks, and music tools implemented (34 total). Webhook receiver live. Importers (importer.py, music_importer.py) run on the media host.