servarr-mcp

MCP-сервер для стека Servarr — Sonarr, Radarr, Lidarr, Readarr и Prowlarr — упакованный в виде Docker-контейнера. Позволяет MCP-клиенту (например, Claude Desktop) просматривать и искать контент в используемых вами приложениях *arr.

Приложения являются опциональными: настройте только те, которые вы действительно используете, и будут зарегистрированы только соответствующие инструменты.

Инструменты

Sonarr (ТВ)

Инструмент	Описание
`sonarr_list_series`	Список всех ТВ-сериалов, отслеживаемых Sonarr
`sonarr_get_series`	Детали сериала по ID
`sonarr_lookup_series`	Поиск нового сериала в TVDB для добавления
`sonarr_list_episodes`	Список эпизодов сериала
`sonarr_calendar`	Предстоящие эпизоды
`sonarr_queue`	Текущая очередь загрузок
`sonarr_history`	Недавняя история (сначала новые)

Radarr (фильмы)

Инструмент	Описание
`radarr_list_movies`	Все фильмы, отслеживаемые Radarr
`radarr_get_movie`	Детали фильма по ID
`radarr_lookup_movie`	Поиск нового фильма в TMDB для добавления
`radarr_calendar`	Предстоящие релизы фильмов
`radarr_queue`	Текущая очередь загрузок
`radarr_history`	Недавняя история (сначала новые)

Lidarr (музыка)

Инструмент	Описание
`lidarr_list_artists`	Все исполнители, отслеживаемые Lidarr
`lidarr_get_artist`	Детали исполнителя по ID
`lidarr_lookup_artist`	Поиск нового исполнителя для добавления
`lidarr_list_albums`	Список альбомов (опционально для каждого исполнителя)
`lidarr_queue`	Текущая очередь загрузок
`lidarr_history`	Недавняя история

Readarr (книги)

Инструмент	Описание
`readarr_list_authors`	Все авторы, отслеживаемые Readarr
`readarr_get_author`	Детали автора по ID
`readarr_lookup_author`	Поиск нового автора для добавления
`readarr_list_books`	Список книг (опционально для каждого автора)
`readarr_queue`	Текущая очередь загрузок
`readarr_history`	Недавняя история

Prowlarr (менеджер индексаторов)

Инструмент	Описание
`prowlarr_list_indexers`	Все настроенные индексаторы
`prowlarr_indexer_stats`	Статистика запросов/захватов по индексаторам
`prowlarr_search`	Поиск по включенным индексаторам
`prowlarr_history`	Недавняя история (запросы, захваты)

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

Каждое приложение использует две переменные окружения. Установите обе для приложения, чтобы включить его инструменты; оставьте их не заданными, чтобы полностью пропустить приложение.

Приложение	Переменная URL	Переменная API-ключа	Порт по умолчанию
Sonarr	`SONARR_URL`	`SONARR_API_KEY`	8989
Radarr	`RADARR_URL`	`RADARR_API_KEY`	7878
Lidarr	`LIDARR_URL`	`LIDARR_API_KEY`	8686
Readarr	`READARR_URL`	`READARR_API_KEY`	8787
Prowlarr	`PROWLARR_URL`	`PROWLARR_API_KEY`	9696

API-ключи находятся в разделе Settings → General → API Key каждого приложения.

Должно быть настроено хотя бы одно приложение, иначе сервер завершит работу с ошибкой.

Запуск с помощью Docker

docker build -t servarr-mcp .
docker run -i --rm \
  -e SONARR_URL=http://192.168.1.50:8989 -e SONARR_API_KEY=... \
  -e RADARR_URL=http://192.168.1.50:7878 -e RADARR_API_KEY=... \
  -e PROWLARR_URL=http://192.168.1.50:9696 -e PROWLARR_API_KEY=... \
  servarr-mcp

Использование с Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "servarr": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARR_URL", "-e", "SONARR_API_KEY",
        "-e", "RADARR_URL", "-e", "RADARR_API_KEY",
        "-e", "PROWLARR_URL", "-e", "PROWLARR_API_KEY",
        "servarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://192.168.1.50:8989",
        "SONARR_API_KEY": "...",
        "RADARR_URL": "http://192.168.1.50:7878",
        "RADARR_API_KEY": "...",
        "PROWLARR_URL": "http://192.168.1.50:9696",
        "PROWLARR_API_KEY": "..."
      }
    }
  }
}

Повторите шаблоны -e и env для тех приложений, которые вы используете.

Локальная разработка

npm install
cp .env.example .env  # then edit
SONARR_URL=... SONARR_API_KEY=... npm run dev

Безопасность

Контейнер запускается от имени пользователя без прав root (servarr).
API-ключи передаются через переменные окружения — никогда не вшивайте их в образ.
.githooks/pre-commit запускает gitleaks при каждом коммите. Активируйте его один раз для каждого клона: git config core.hooksPath .githooks.

servarr-mcp

servarr-mcp

Инструменты

Sonarr (ТВ)

Radarr (фильмы)

Lidarr (музыка)

Readarr (книги)

Prowlarr (менеджер индексаторов)

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

Запуск с помощью Docker

Использование с Claude Desktop

Локальная разработка

Безопасность

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API