Skip to main content
Glama
CT4nk3r

arrstack-mcp

by CT4nk3r

🎬 arrstack-mcp

MCP-сервер, который предоставляет ИИ-ассистентам управление вашим медиа-стеком homelab: Sonarr, Radarr, Prowlarr, qBittorrent и Jellyfin.

Работает с Claude Desktop, Cursor, VS Code Copilot, OpenClaw и любым другим MCP-совместимым клиентом.

Демо

OpenClaw использует arrstack-mcp для поиска и загрузки медиа

Related MCP server: nas-mcp-server

Возможности

Сервис

Инструменты

Sonarr

Список сериалов, поиск и добавление шоу, предстоящие эпизоды, очередь загрузки

Radarr

Список фильмов, поиск и добавление фильмов, очередь загрузки

Prowlarr

Список/тест индексаторов, поиск релизов, проверка состояния

qBittorrent

Список/пауза/возобновление/удаление торрентов, добавление magnet-ссылок, статистика передачи

Jellyfin

Список библиотек, недавние добавления, системная информация

Настраивайте только те сервисы, которые вы используете — ненастроенные сервисы корректно пропускаются.

Быстрый старт

Вариант 1: Claude Desktop / Cursor / VS Code (stdio)

  1. Установите зависимости:

    pip install "mcp[cli]>=1.9.0" httpx
  2. Добавьте в конфигурацию вашего MCP-клиента (например, 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. Перезапустите MCP-клиент. Готово!

Вариант 2: Docker (HTTP-транспорт)

Для удаленных настроек или при запуске вместе с вашим стеком *arr:

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

Сервер работает на порту 8000 с использованием потокового HTTP-транспорта.

Подключение к OpenClaw

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

Подключение к другим HTTP MCP-клиентам

Укажите вашему клиенту адрес http://<host>:8000/mcp, используя потоковый HTTP-транспорт.

Вариант 3: Docker в той же сети, что и ваш стек *arr

Если ваши медиа-сервисы запущены в Docker, добавьте arrstack-mcp в ту же сеть:

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

Конфигурация

Вся конфигурация осуществляется через переменные окружения:

Переменная

Обязательно

Описание

SONARR_URL

Нет

Базовый URL Sonarr (например, http://localhost:8989)

SONARR_API_KEY

Если Sonarr

API-ключ Sonarr (Настройки → Общие)

RADARR_URL

Нет

Базовый URL Radarr (например, http://localhost:7878)

RADARR_API_KEY

Если Radarr

API-ключ Radarr (Настройки → Общие)

QBT_URL

Нет

URL веб-интерфейса qBittorrent (например, http://localhost:8080)

QBT_USER

Если qBt

Имя пользователя qBittorrent (по умолчанию: admin)

QBT_PASS

Если qBt

Пароль qBittorrent

JELLYFIN_URL

Нет

Базовый URL Jellyfin (например, http://localhost:8096)

JELLYFIN_API_KEY

Нет

API-ключ Jellyfin (опционально, для аутентифицированных эндпоинтов)

PROWLARR_URL

Нет

Базовый URL Prowlarr (например, http://localhost:9696)

PROWLARR_API_KEY

Если Prowlarr

API-ключ Prowlarr (Настройки → Общие)

Доступные инструменты

Sonarr (ТВ-шоу)

Инструмент

Описание

sonarr_list_series

Список всех сериалов с количеством эпизодов и использованием диска

sonarr_get_series

Получить подробную информацию о конкретном сериале

sonarr_search

Поиск новых шоу для добавления

sonarr_add_series

Добавить шоу по TVDB ID

sonarr_upcoming

Показать предстоящие эпизоды

sonarr_queue

Показать текущую очередь загрузки

Radarr (Фильмы)

Инструмент

Описание

radarr_list_movies

Список всех фильмов со статусом загрузки

radarr_get_movie

Получить подробную информацию о конкретном фильме

radarr_search

Поиск новых фильмов для добавления

radarr_add_movie

Добавить фильм по TMDB ID

radarr_queue

Показать текущую очередь загрузки

Prowlarr (Индексаторы)

Инструмент

Описание

prowlarr_list_indexers

Список всех индексаторов со статусом

prowlarr_test_indexer

Проверить соединение с конкретным индексатором

prowlarr_test_all_indexers

Проверить все включенные индексаторы

prowlarr_search

Поиск релизов по индексаторам

prowlarr_health

Проверить предупреждения о состоянии системы

qBittorrent (Загрузки)

Инструмент

Описание

qbt_list_torrents

Список торрентов с прогрессом и скоростью

qbt_torrent_details

Получить подробную информацию о торренте

qbt_add_magnet

Добавить magnet-ссылку

qbt_pause

Поставить торрент на паузу

qbt_resume

Возобновить торрент

qbt_delete

Удалить торрент (опционально с файлами)

qbt_transfer_info

Глобальная статистика передачи

Jellyfin (Медиа-сервер)

Инструмент

Описание

jellyfin_libraries

Список медиа-библиотек

jellyfin_recent

Недавно добавленные элементы

jellyfin_system_info

Версия сервера и системная информация

Варианты транспорта

# 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

Поиск ваших API-ключей

  • Sonarr: Настройки → Общие → API Key

  • Radarr: Настройки → Общие → API Key

  • Prowlarr: Настройки → Общие → API Key

  • qBittorrent: Настройки → Web UI → Аутентификация

  • Jellyfin: Панель управления → API Keys → Добавить

Лицензия

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
    12
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A self-hosted MCP gateway that lets AI assistants drive your media services like Radarr and Sonarr through a single authenticated endpoint.
    AGPL 3.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that gives AI assistants real-time access to your homelab infrastructure. It enables querying node status, managing Docker containers, controlling Proxmox VMs, and inspecting OPNsense firewall state through natural conversation.
    2
    MIT