prowlarr-mcp

MCP-сервер для Prowlarr.

Настройка

cd prowlarr-mcp
uv sync
cp .env.example .env

Укажите PROWLARR_API_KEY в .env. API-ключ доступен в Prowlarr в разделе Настройки → Общие → Безопасность.

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

Related MCP server: qBittorrent MCP Server

Запуск

uv run prowlarr-mcp

Пример stdio-конфигурации в стиле Codex/OpenCode:

{
  "command": "uv",
  "args": [
    "--directory",
    "/path/to/prowlarr-mcp",
    "run",
    "prowlarr-mcp"
  ]
}

Инструмент

search_releases принимает:

• query: текстовый запрос; пустая строка запрашивает последние релизы.

• search_type: search, tvsearch, movie, music или book.

• indexer_ids: опциональные идентификаторы индексаторов Prowlarr.

• categories: опциональные идентификаторы категорий Newznab.

• limit: количество результатов, по умолчанию 20 и ограничено конфигурацией.

• offset: неотрицательное смещение результата.

Ответ намеренно меньше полного ReleaseResource Prowlarr, но сохраняет indexer_id и guid для будущего рабочего процесса отправки загрузок. Prowlarr может применять limit независимо к нескольким индексаторам, поэтому MCP-сервер также применяет его к объединённому ответу. truncated означает, что MCP-сервер отбросил часть ответа, который он получил; это не индикатор постраничной навигации has_more и не может подтвердить, есть ли в Prowlarr дополнительные результаты.

Дорожная карта

• v0.1: Поиск релизов через настроенные индексаторы Prowlarr.

• Обнаружение доступных индексаторов и категорий поиска.

• Отправка выбранного релиза в настроенный клиент загрузки.

• Просмотр состояния Prowlarr, статуса индексаторов и истории поиска.

Тестирование с MCP-клиентом

Репозиторий содержит универсальный stdio-клиент для запуска сервера и вызова одного инструмента:

uv run src/prowlarr_mcp/scripts/mcp_client.py \
  --command "uv run prowlarr-mcp" \
  --method "search_releases" \
  --arguments '{"query": "yani neko"}'

Используйте --cwd, когда команда сервера должна выполняться из другого каталога, и --timeout, чтобы переопределить таймаут вызова инструмента по умолчанию (60 секунд). Скрипт выводит структурированные данные инструмента в формате JSON и завершается с ненулевым кодом при некорректном вводе, ошибках подключения или ошибках инструментов MCP.

Разработка

uv run ruff format --check .
uv run ruff check .
uv run pyrefly check
uv run python -m unittest discover -s tests