Yarr MCP — MCP-сервер для Claude Code: что делает и как установить
Даёт ИИ-агентам доступ к домашнему медиасерверу: проверяет статус и управляет Sonarr, Radarr или Plex через протокол MCP.
claude mcp add --env YARR_SONARR_URL=<YARR_SONARR_URL> --env YARR_SONARR_API_KEY=<YARR_SONARR_API_KEY> --env YARR_RADARR_URL=<YARR_RADARR_URL> --env YARR_RADARR_API_KEY=<YARR_RADARR_API_KEY> --env YARR_PLEX_URL=<YARR_PLEX_URL> --transport stdio yarr-mcp -- npx -y @dinglebear/yarrЧто делает Yarr MCP
Сервер собирает приложения домашнего медиастека под единым интерфейсом управления. Вместо создания отдельных интеграций под каждый сервис агент отправляет запросы к единому слою yarr. Оператор может повторять те же действия в терминале через утилиту командной строки.
Для сервисов со структурированными спецификациями OpenAPI (Sonarr, Radarr, Prowlarr, Overseerr, Jellyfin, Plex) вызовы строятся по их метаданным. Для SABnzbd, Bazarr или qBittorrent сервер предоставляет фиксированные наборы команд. Также поддерживается режим Code Mode для выполнения цепочек автоматизации.
Ключи доступа нельзя передавать аргументами команд внутри диалога с моделью. Все токены считываются исключительно из переменных окружения или конфигурационных файлов при запуске. Сервер не хранит задачи сам и не заменяет веб-интерфейсы приложений.
Какие задачи решает
- Проверять состояние сервисов Sonarr, Radarr и Plex из единой точки
- Управлять медиастеком через стандартизированные вызовы OpenAPI
- Запускать цепочки действий в режиме Code Mode без сторонних шлюзов
- Исключить передачу API-ключей в открытом тексте диалога с агентом
Примеры запросов агенту
- Проверь статус сервисов Sonarr и Plex через yarr
- Покажи доступные операции для Radarr в текущей конфигурации флота
- Запусти сохранённый сниппет проверки очереди загрузок в qBittorrent
Как установить Yarr MCP
Командой платформы
claude mcp add --env YARR_SONARR_URL=<YARR_SONARR_URL> --env YARR_SONARR_API_KEY=<YARR_SONARR_API_KEY> --env YARR_RADARR_URL=<YARR_RADARR_URL> --env YARR_RADARR_API_KEY=<YARR_RADARR_API_KEY> --env YARR_PLEX_URL=<YARR_PLEX_URL> --transport stdio yarr-mcp -- npx -y @dinglebear/yarrВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
codex mcp add yarr-mcp --env YARR_SONARR_URL=<YARR_SONARR_URL> --env YARR_SONARR_API_KEY=<YARR_SONARR_API_KEY> --env YARR_RADARR_URL=<YARR_RADARR_URL> --env YARR_RADARR_API_KEY=<YARR_RADARR_API_KEY> --env YARR_PLEX_URL=<YARR_PLEX_URL> -- npx -y @dinglebear/yarrВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"mcpServers": {
"yarr-mcp": {
"command": "npx",
"args": [
"-y",
"@dinglebear/yarr"
],
"env": {
"YARR_SONARR_URL": "<YARR_SONARR_URL>",
"YARR_SONARR_API_KEY": "<YARR_SONARR_API_KEY>",
"YARR_RADARR_URL": "<YARR_RADARR_URL>",
"YARR_RADARR_API_KEY": "<YARR_RADARR_API_KEY>",
"YARR_PLEX_URL": "<YARR_PLEX_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Файл настроек
{
"servers": {
"yarr-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@dinglebear/yarr"
],
"env": {
"YARR_SONARR_URL": "<YARR_SONARR_URL>",
"YARR_SONARR_API_KEY": "<YARR_SONARR_API_KEY>",
"YARR_RADARR_URL": "<YARR_RADARR_URL>",
"YARR_RADARR_API_KEY": "<YARR_RADARR_API_KEY>",
"YARR_PLEX_URL": "<YARR_PLEX_URL>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
Командой платформы
gemini mcp add -e YARR_SONARR_URL=<YARR_SONARR_URL> -e YARR_SONARR_API_KEY=<YARR_SONARR_API_KEY> -e YARR_RADARR_URL=<YARR_RADARR_URL> -e YARR_RADARR_API_KEY=<YARR_RADARR_API_KEY> -e YARR_PLEX_URL=<YARR_PLEX_URL> yarr-mcp npx -y @dinglebear/yarrВместо <…> подставьте свои значения. Ещё 5 переменных окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Yarr MCP
Как установить Yarr MCP в Claude Code?
Выполните команду `claude mcp add yarr -e YARR_SONARR_API_KEY=<YARR_SONARR_API_KEY> -e YARR_RADARR_API_KEY=<YARR_RADARR_API_KEY> -e YARR_PLEX_TOKEN=<YARR_PLEX_TOKEN> -- npx -y @dinglebear/yarr`. Значения переменных окружения укажите для тех сервисов, которые развёрнуты в вашей сети.
Что делает Yarr MCP?
Он предоставляет агенту единый инструмент для работы с сервисами управления медиа. Тот же интерфейс доступен оператору напрямую через CLI.
Можно ли передать токен сервиса в тексте запроса?
Нет, архитектура сервера прямо блокирует приём секретов в аргументах вызовов. Все авторизационные ключи задаются заранее в переменных окружения.
