prowlarr-mcp

prowlarr-mcp

Prowlarr용 MCP 서버입니다.

설정

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

.env에 PROWLARR_API_KEY를 설정하세요. API 키는 Prowlarr의 Settings → General → Security 경로에서 확인할 수 있습니다.

구성:

Related MCP server: qBittorrent MCP Server

실행

uv run prowlarr-mcp

Codex/OpenCode 스타일 stdio 구성 예시:

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

도구

search_releases는 다음을 허용합니다:

• query: 텍스트 검색어. 빈 문자열은 최신 릴리스를 요청합니다.

• search_type: search, tvsearch, movie, music, 또는 book.

• indexer_ids: 선택적 Prowlarr 인덱서 ID.

• categories: 선택적 Newznab 카테고리 ID.

• limit: 결과 수. 기본값은 20이며 구성에 따라 상한이 적용됩니다.

• offset: 음수가 아닌 결과 오프셋.

응답은 의도적으로 Prowlarr의 전체 ReleaseResource보다 작지만, 향후 다운로드 제출 워크플로를 위해 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를 사용하고, 기본 60초 도구 호출 타임아웃을 재정의하려면 --timeout을 사용하세요. 스크립트는 구조화된 도구 출력을 JSON으로 출력하며, 잘못된 입력, 연결 실패 또는 MCP 도구 오류가 발생하면 0이 아닌 코드로 종료합니다.

개발

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