# mcp-arr

MCP-сервер, через который агент управляет медиатекой: ищет сериалы, фильмы и музыку, ставит загрузки, смотрит очередь и календарь релизов.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 234
- Автор: aplaceforallmystuff
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/aplaceforallmystuff/mcp-arr
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/mcp/mcp-arr

## Что делает

Сервер связывает клиент с приложениями *arr: Sonarr отвечает за сериалы, Radarr за фильмы, Lidarr за музыку, Prowlarr за индексеры. Агент перечисляет библиотеку, ищет контент сразу по нескольким сервисам, запускает загрузку, проверяет очередь и здоровье индексеров. Отдельный блок инструментов — справочник TRaSH Guides: профили качества, кастомные форматы, схемы именования. Если ни один *arr не настроен, сервер всё равно стартует и отдаёт эти справочники.

Запускается двумя способами. Локально — через `npx mcp-arr-server` по stdio, так работают Claude, Codex, Cursor, Copilot, Windsurf, Cline и Zed. Для удалённых клиентов есть HTTP-режим: `MCP_TRANSPORT=http PORT=3000 npx mcp-arr-server`, по умолчанию слушает `127.0.0.1:3000` и отдаёт MCP на `/mcp`. Есть готовые образы в GitHub Container Registry, собирать самому не нужно.

Что нужно заранее: Node.js 18+ и хотя бы одно приложение *arr с доступом по API. Ключ лежит в Settings > General > Security каждого приложения, URL и ключ передаются переменными окружения. Настраивайте только те сервисы, которые реально запущены — сервер определяет доступные по переменным. Без ключа Prowlarr, например, поиск по трекерам просто не заработает.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `SONARR_URL`, `SONARR_API_KEY`, `RADARR_URL`, `RADARR_API_KEY`, `LIDARR_URL`, `LIDARR_API_KEY`, `READARR_URL`, `READARR_API_KEY`, `PROWLARR_URL`, `PROWLARR_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add mcp-arr -e SONARR_API_KEY=<SONARR_API_KEY> -e RADARR_API_KEY=<RADARR_API_KEY> -e LIDARR_API_KEY=<LIDARR_API_KEY> -e READARR_API_KEY=<READARR_API_KEY> -e PROWLARR_API_KEY=<PROWLARR_API_KEY> -- npx -y mcp-arr-server
```
Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add mcp-arr --env SONARR_URL=<SONARR_URL> --env SONARR_API_KEY=<SONARR_API_KEY> --env RADARR_URL=<RADARR_URL> --env RADARR_API_KEY=<RADARR_API_KEY> --env LIDARR_URL=<LIDARR_URL> -- npx -y mcp-arr-server
```
Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-arr": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-arr-server"
            ],
            "env": {
                "SONARR_URL": "<SONARR_URL>",
                "SONARR_API_KEY": "<SONARR_API_KEY>",
                "RADARR_URL": "<RADARR_URL>",
                "RADARR_API_KEY": "<RADARR_API_KEY>",
                "LIDARR_URL": "<LIDARR_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-arr": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "mcp-arr-server"
            ],
            "env": {
                "SONARR_URL": "<SONARR_URL>",
                "SONARR_API_KEY": "<SONARR_API_KEY>",
                "RADARR_URL": "<RADARR_URL>",
                "RADARR_API_KEY": "<RADARR_API_KEY>",
                "LIDARR_URL": "<LIDARR_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e SONARR_URL=<SONARR_URL> -e SONARR_API_KEY=<SONARR_API_KEY> -e RADARR_URL=<RADARR_URL> -e RADARR_API_KEY=<RADARR_API_KEY> -e LIDARR_URL=<LIDARR_URL> mcp-arr npx -y mcp-arr-server
```
Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера

## Когда брать
- найти сериал или фильм сразу по нескольким сервисам
- поставить загрузку, не открывая веб-интерфейс Sonarr
- проверить очередь и прогресс загрузок по всем приложениям
- посмотреть календарь ближайших релизов сериалов и альбомов
- сверить профили качества и схемы именования с рекомендациями TRaSH Guides

## Примеры запросов агенту
- покажи, что сейчас качается в Sonarr и Radarr
- найди этот сериал и поставь на загрузку
- сравни мой профиль качества с рекомендациями TRaSH Guides

## Похожие
- [Spotify Automation](https://affpapa.org/nevibecode/skills/spotify-automation.md) — скилл · 4600 установок
- [wonda-cli](https://affpapa.org/nevibecode/skills/wonda-cli.md) — скилл · 74600 установок
- [video-to-gif](https://affpapa.org/nevibecode/skills/video-to-gif.md) — скилл · 3900 установок
- [video-batch-runner](https://affpapa.org/nevibecode/skills/video-batch-runner.md) — скилл · 1000 установок
- [cloudinary-transformations](https://affpapa.org/nevibecode/skills/cloudinary-transformations.md) — скилл · 852 установки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md