mcp-arr-lite

Легковесный MCP-сервер для Radarr и Sonarr с небольшим набором целенаправленных инструментов. Неофициальный проект.

Зачем этот проект?

Обычные MCP-серверы для "arr" (например, Knuckles-Team/arr-mcp) автоматически генерируют тысячи инструментов из Arr API и передают всю поверхность LLM. mcp-arr-lite — полная противоположность:

• Детальные инструменты: ровно те операции, которые нужны для сценария "можешь загрузить X?" — поиск, добавление, поиск релизов, загрузка — никакого административного/конфигурационного шума.

• Логика предпочтительного индексера: инструменты поиска по умолчанию используют индексатор с наименьшим числовым приоритетом, детерминированно, а не в зависимости от подсказки.

• Удобно для HITL: инструменты только для чтения (поиск, список индексаторов) можно автоматически одобрять; добавление/поиск/загрузка требуют явного одобрения пользователя.

• Двойной транспорт: stdio (npx) и HTTP (Docker).

Сравнение с Knuckles-Team/arr-mcp

Related MCP server: overseerr-mcp

Инструменты

Требования

• Node.js >= 20 (npx) или Docker (контейнер)

• Radarr и/или Sonarr с API-ключом

Установка

Docker Compose (рекомендуется)

services:
  arr-mcp:
    image: ghcr.io/cuti27/mcp-arr-lite:latest
    restart: unless-stopped
    environment:
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - MCP_TRANSPORT=http
      - MCP_AUTH_TOKEN=your-secure-token-here
      - PORT=3000
      - HOST=0.0.0.0
      - LOG_LEVEL=info

Настраивайте только те приложения, которые используете — Radarr и Sonarr опциональны при запуске; инструменты для ненастроенного приложения вернут ошибку.

stdio (npx)

RADARR_URL=http://radarr:7878 \
RADARR_API_KEY=... \
SONARR_URL=http://sonarr:8989 \
SONARR_API_KEY=... \
MCP_TRANSPORT=stdio \
npx -y @cuti27/mcp-arr-lite

Переменные окружения

См. .env.example. Обязательно для каждого приложения: RADARR_URL + RADARR_API_KEY, SONARR_URL + SONARR_API_KEY. MCP_AUTH_TOKEN требуется, когда MCP_TRANSPORT=http.

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

• HTTP-транспорт обеспечивает Bearer-аутентификацию, ограничение частоты запросов (60 запросов/мин/IP) и лимит тела запроса в 1 МБ.

• API-ключи скрываются из логов.

• Запускайте HTTP-транспорт только с установленным MCP_AUTH_TOKEN и за TLS-терминирующим обратным прокси.

Лицензия

MIT