convez.ai
MCP Server
CT4nk3r

arrstack-mcp

CT4nk3r/arrstack-mcp

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server for Sonarr, Radarr, qBittorrent & Jellyfin — give your AI assistant control over your media stack

Instalação

$npx convez-ai CT4nk3r/arrstack-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
8
Forks
8
Acompanhando
0
Saúde
42%
Último commit
há 3 semanas
Versão
v0.1.0
Issues abertas
3
Contribuidores
1

README

A tradução para o português deste README ainda está na fila.

🎬 arrstack-mcp

An MCP server that gives AI assistants configurable access to homelab media and game services.

Works with Claude Desktop, Cursor, VS Code Copilot, OpenClaw, and any other MCP-compatible client.

Demo

Adding a movie with natural language

Features

ServiceTools
SonarrList series, search & add shows, upcoming episodes, download queue
RadarrList movies, search & add movies, download queue
LidarrList artists, search & add artists/albums, queue, missing search
ProwlarrList/test indexers, search releases, health check
qBittorrentList/pause/resume/delete torrents, add magnets, transfer stats
SABnzbdQueue, history, status, pause/resume, add NZB url, speed limit
RDTClientReal-Debrid downloader: list/pause/resume/delete torrents, add magnets, provider status
JellyfinList libraries, recent additions, system info
RomMSystem info, list platforms, list/search ROMs, game details
GameVaultList/search PC games, game details, random game, reindex library
BookshelfList/search authors & books, queue, missing, profiles, health

Only configure the services you use — unconfigured services are gracefully skipped.

Choose Your Services

To avoid flooding an MCP client's context with tools it does not need, the advertised tool catalog is configurable:

  • ENABLED_SERVICES=auto (default) advertises only services with a configured URL.
  • A comma-separated list such as sonarr,radarr,romm advertises exactly that subset.
  • ENABLED_SERVICES=all advertises every available tool.
  • Run python server.py --list-services to inspect configured/enabled services.
  • Run python server.py --setup for an interactive selector that prints the resulting ENABLED_SERVICES line.

Valid service names are sonarr, radarr, lidarr, prowlarr, qbittorrent, rdtclient, sabnzbd, jellyfin, romm, gamevault, and bookshelf. Aliases qbt, rdt, and sab are also accepted.

Quick Start

Option 1: Claude Desktop / Cursor / VS Code (stdio)

  1. Install dependencies:

    pip install "mcp[cli]>=1.9.0" httpx
    
  2. Add to your MCP client config (e.g. claude_desktop_config.json):

    {
      "mcpServers": {
        "arrstack": {
          "command": "python",
          "args": ["/path/to/arrstack-mcp/server.py"],
          "env": {
            "SONARR_URL": "http://localhost:8989",
            "SONARR_API_KEY": "your-api-key",
            "RADARR_URL": "http://localhost:7878",
            "RADARR_API_KEY": "your-api-key",
            "QBT_URL": "http://localhost:8080",
            "QBT_USER": "admin",
            "QBT_PASS": "your-password",
            "JELLYFIN_URL": "http://localhost:8096"
          }
        }
      }
    }
    
  3. Restart your MCP client. Done!

Option 2: Docker (HTTP transport)

For remote setups or when running alongside your *arr stack:

git clone https://github.com/ct4nk3r/arrstack-mcp.git
cd arrstack-mcp
cp .env.example .env
# Edit .env with your service URLs and API keys
docker compose up -d

The server runs on port 8000 with Streamable HTTP transport.

Connect to OpenClaw

openclaw mcp set arrstack '{"url":"http://arrstack-mcp:8000/mcp","transport":"streamable-http"}'

Connect to other HTTP MCP clients

Point your client to http://<host>:8000/mcp using Streamable HTTP transport.

Option 3: Docker on the same network as your *arr stack

If your media services run in Docker, add arrstack-mcp to the same network:

services:
  arrstack-mcp:
    build: .
    container_name: arrstack-mcp
    ports:
      - "8000:8000"
    environment:
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-key
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-key
      - QBT_URL=http://qbittorrent:8080
      - QBT_USER=admin
      - QBT_PASS=your-password
      - JELLYFIN_URL=http://jellyfin:8096
    networks:
      - your-media-network

Configuration

All configuration is done via environment variables:

VariableRequiredDescription
ENABLED_SERVICESNoauto (default), all, or a comma-separated service subset
SONARR_URLNoSonarr base URL (e.g. http://localhost:8989)
SONARR_API_KEYIf SonarrSonarr API key (Settings → General)
RADARR_URLNoRadarr base URL (e.g. http://localhost:7878)
RADARR_API_KEYIf RadarrRadarr API key (Settings → General)
LIDARR_URLNoLidarr base URL (e.g. http://localhost:8686)
LIDARR_API_KEYIf LidarrLidarr API key (Settings → General)
QBT_URLNoqBittorrent Web UI URL (e.g. http://localhost:8080)
QBT_USERIf qBtqBittorrent username (default: admin)
QBT_PASSIf qBtqBittorrent password
RDT_URLNoRDTClient base URL (e.g. http://localhost:6500)
RDT_USERIf RDT loginRDTClient username (default: admin)
RDT_PASSIf RDT loginRDTClient password
JELLYFIN_URLNoJellyfin base URL (e.g. http://localhost:8096)
JELLYFIN_API_KEYNoJellyfin API key (optional, for authenticated endpoints)
PROWLARR_URLNoProwlarr base URL (e.g. http://localhost:9696)
PROWLARR_API_KEYIf ProwlarrProwlarr API key (Settings → General)
ROMM_URLNoRomM base URL (e.g. http://localhost:8081)
ROMM_API_TOKENIf RomMRomM bearer token; alternatively use ROMM_USER and ROMM_PASS
ROMM_USERIf RomM basic authRomM username
ROMM_PASSIf RomM basic authRomM password
GAMEVAULT_URLNoGameVault server URL (e.g. http://localhost:8082)
GAMEVAULT_API_KEYIf GameVaultGameVault API key
MCP_ALLOWED_HOSTSFor HTTP/SSEComma-separated accepted Host headers; supports wildcard ports such as arrstack-mcp:*
LOG_LEVELNoRequest logging level (default: INFO; credentials are never logged)
SAB_URLNoSABnzbd base URL (e.g. http://localhost:8080)
SAB_API_KEYIf SABnzbdSABnzbd API key (Config → General → API Key)
BOOKSHELF_URLNoBookshelf base URL (e.g. http://localhost:8787)
BOOKSHELF_API_KEYIf BookshelfBookshelf API key (Settings → General)

Available Tools

Sonarr (TV Shows)

ToolDescription
sonarr_list_seriesList all series with episode counts and disk usage
sonarr_get_seriesGet detailed info about a specific series
sonarr_searchSearch for new shows to add
sonarr_add_seriesAdd a show by TVDB ID
sonarr_upcomingShow upcoming episodes
sonarr_queueShow current download queue

Radarr (Movies)

ToolDescription
radarr_list_moviesList all movies with download status
radarr_get_movieGet detailed info about a specific movie
radarr_searchSearch for new movies to add
radarr_add_movieAdd a movie by TMDB ID
radarr_queueShow current download queue

Lidarr (Music)

ToolDescription
lidarr_list_artistsList all artists with album/track counts and disk usage
lidarr_get_artistGet detailed info about a specific artist
lidarr_searchSearch for artists to add
lidarr_search_albumSearch for albums in metadata
lidarr_add_artistAdd an artist by name (requires quality + metadata profile + root folder)
lidarr_list_quality_profilesList quality profiles
lidarr_list_metadata_profilesList metadata profiles
lidarr_list_root_foldersList root folders with free space
lidarr_queueShow current download queue
lidarr_delete_queue_itemRemove an item from the queue (optionally blocklist)
lidarr_search_missingTrigger search for all missing albums

Prowlarr (Indexers)

ToolDescription
prowlarr_list_indexersList all indexers with status
prowlarr_test_indexerTest a specific indexer connection
prowlarr_test_all_indexersTest all enabled indexers
prowlarr_searchSearch across indexers for releases
prowlarr_healthCheck system health warnings

qBittorrent (Downloads)

ToolDescription
qbt_list_torrentsList torrents with progress and speed
qbt_torrent_detailsGet detailed torrent info
qbt_add_magnetAdd a magnet link
qbt_pausePause a torrent
qbt_resumeResume a torrent
qbt_deleteDelete a torrent (optionally with files)
qbt_transfer_infoGlobal transfer statistics

SABnzbd (Usenet Downloads)

ToolDescription
sab_queueShow the current download queue
sab_historyShow download history
sab_statusShow full server status (disk, speed, etc.)
sab_pausePause the entire queue
sab_resumeResume the entire queue
sab_pause_jobPause a specific queue item by NZO id
sab_resume_jobResume a specific queue item by NZO id
sab_delete_jobDelete a queue item (optionally with files)
sab_add_urlAdd an NZB by URL (with optional category/priority)
sab_speed_limitSet the global speed limit (0..100% of configured max)

RDTClient (Real-Debrid Downloader)

RDTClient is a Real-Debrid / AllDebrid / Premiumize download manager that exposes a qBittorrent-compatible API, so it slots into Sonarr/Radarr just like qBt.

ToolDescription
rdt_list_torrentsList torrents with progress and speed
rdt_torrent_detailsGet detailed torrent info
rdt_add_magnetAdd a magnet link to your debrid provider
rdt_pausePause one or more torrents
rdt_resumeResume one or more torrents
rdt_deleteDelete one or more torrents (optionally with files)
rdt_provider_statusShow configured debrid provider (Real-Debrid / AllDebrid / etc.)

Jellyfin (Media Server)

ToolDescription
jellyfin_librariesList media libraries
jellyfin_recentRecently added items
jellyfin_system_infoServer version and system info

RomM (ROM Library)

ToolDescription
romm_system_infoShow version, detected platforms, and metadata sources
romm_list_platformsList platforms, ROM counts, and library sizes
romm_list_gamesList or search indexed ROMs
romm_get_gameShow details for one indexed ROM

GameVault (PC Game Library)

ToolDescription
gamevault_list_gamesList or search PC games and installers
gamevault_get_gameShow details for one game
gamevault_random_gamePick a random indexed game
gamevault_reindexScan the game-files directory for changes

Bookshelf (Books — Hardcover-flavored Readarr fork)

Bookshelf is pennydreadful/bookshelf, a fork of Readarr that uses hardcover.app as its metadata provider. It exposes the standard Readarr v1 API, so these tools behave like the Sonarr/Radarr/Lidarr equivalents.

ToolDescription
bookshelf_healthVersion + active health-check issues
bookshelf_list_authorsList monitored authors with book counts and disk usage
bookshelf_get_authorDetailed info for an author by ID
bookshelf_search_authorSearch Hardcover for an author
bookshelf_search_bookSearch Hardcover for a book
bookshelf_list_booksList all tracked books
bookshelf_queueCurrent download queue
bookshelf_wanted_missingBooks flagged as missing
bookshelf_list_quality_profilesQuality profiles
bookshelf_list_metadata_profilesMetadata profiles
bookshelf_list_root_foldersRoot folders with free space
bookshelf_search_missingTrigger a search for all missing books

Transport Options

# stdio (default) — for Claude Desktop, Cursor, VS Code
python server.py

# Streamable HTTP — for Docker / remote
python server.py --transport streamable-http --port 8000

# SSE — legacy HTTP transport
python server.py --transport sse --port 8000

Finding Your API Keys

  • Sonarr: Settings → General → API Key
  • Radarr: Settings → General → API Key
  • Lidarr: Settings → General → API Key
  • Prowlarr: Settings → General → API Key
  • qBittorrent: Settings → Web UI → Authentication
  • SABnzbd: Config → General → API Key
  • RDTClient: Settings → General → Authentication (or set Authentication: None to allow open access on a trusted network)
  • Jellyfin: Dashboard → API Keys → Add
  • RomM: User profile → API Tokens, or configure ROMM_USER and ROMM_PASS
  • GameVault: Admin panel → API Keys
  • Bookshelf: Settings → General → API Key (same as Readarr)

Security

The HTTP/SSE transports listen on 0.0.0.0:8000 by default, and MCP does not provide authentication by itself. Anyone who can reach that port can invoke tools using the configured service credentials.

  • Prefer stdio for same-machine clients.
  • For remote access, restrict port 8000 to Tailscale or place it behind an authenticated reverse proxy.
  • DNS-rebinding protection is enabled. Set MCP_ALLOWED_HOSTS to the exact hostnames or IP addresses clients use, with optional wildcard ports: localhost:*,127.0.0.1:*,arrstack-mcp:*,100.64.0.1:*.
  • The Docker image runs as non-root user appuser with UID 1000.
  • API keys and request headers are never logged.

License

MIT

Ver o original no GitHub

Relacionados