servarr-mcp

Servarr 스택(Sonarr, Radarr, Lidarr, Readarr, Prowlarr)을 위한 MCP 서버로, Docker 컨테이너로 패키징되어 있습니다. MCP 클라이언트(Claude Desktop 등)가 실행 중인 *arr 앱을 탐색하고 검색할 수 있게 해줍니다.

앱은 선택 사항입니다. 실제로 실행 중인 앱만 구성하면 해당 도구만 등록됩니다.

도구

Sonarr (TV)

도구	설명
`sonarr_list_series`	Sonarr가 추적하는 모든 TV 시리즈 목록
`sonarr_get_series`	ID별 시리즈 세부 정보
`sonarr_lookup_series`	추가할 새 시리즈를 TVDB에서 검색
`sonarr_list_episodes`	시리즈의 에피소드 목록
`sonarr_calendar`	예정된 에피소드
`sonarr_queue`	현재 다운로드 대기열
`sonarr_history`	최근 기록 (최신순)

Radarr (영화)

도구	설명
`radarr_list_movies`	Radarr가 추적하는 모든 영화 목록
`radarr_get_movie`	ID별 영화 세부 정보
`radarr_lookup_movie`	추가할 새 영화를 TMDB에서 검색
`radarr_calendar`	예정된 영화 개봉일
`radarr_queue`	현재 다운로드 대기열
`radarr_history`	최근 기록 (최신순)

Lidarr (음악)

도구	설명
`lidarr_list_artists`	Lidarr가 추적하는 모든 아티스트 목록
`lidarr_get_artist`	ID별 아티스트 세부 정보
`lidarr_lookup_artist`	추가할 새 아티스트 검색
`lidarr_list_albums`	앨범 목록 (아티스트별 선택 가능)
`lidarr_queue`	현재 다운로드 대기열
`lidarr_history`	최근 기록

Readarr (도서)

도구	설명
`readarr_list_authors`	Readarr가 추적하는 모든 저자 목록
`readarr_get_author`	ID별 저자 세부 정보
`readarr_lookup_author`	추가할 새 저자 검색
`readarr_list_books`	도서 목록 (저자별 선택 가능)
`readarr_queue`	현재 다운로드 대기열
`readarr_history`	최근 기록

Prowlarr (인덱서 관리자)

도구	설명
`prowlarr_list_indexers`	구성된 모든 인덱서
`prowlarr_indexer_stats`	인덱서별 쿼리/그랩 통계
`prowlarr_search`	활성화된 인덱서 전체 검색
`prowlarr_history`	최근 기록 (쿼리, 그랩)

구성

각 앱은 두 개의 환경 변수를 사용합니다. 도구를 활성화하려면 앱에 대해 두 변수를 모두 설정하고, 앱을 완전히 건너뛰려면 설정하지 마십시오.

앱	URL 변수	API 키 변수	기본 포트
Sonarr	`SONARR_URL`	`SONARR_API_KEY`	8989
Radarr	`RADARR_URL`	`RADARR_API_KEY`	7878
Lidarr	`LIDARR_URL`	`LIDARR_API_KEY`	8686
Readarr	`READARR_URL`	`READARR_API_KEY`	8787
Prowlarr	`PROWLARR_URL`	`PROWLARR_API_KEY`	9696

API 키는 각 앱의 설정 → 일반 → API 키에서 찾을 수 있습니다.

최소 하나 이상의 앱이 구성되어야 하며, 그렇지 않으면 서버가 오류와 함께 종료됩니다.

Docker로 실행

docker build -t servarr-mcp .
docker run -i --rm \
  -e SONARR_URL=http://192.168.1.50:8989 -e SONARR_API_KEY=... \
  -e RADARR_URL=http://192.168.1.50:7878 -e RADARR_API_KEY=... \
  -e PROWLARR_URL=http://192.168.1.50:9696 -e PROWLARR_API_KEY=... \
  servarr-mcp

Claude Desktop과 함께 사용

claude_desktop_config.json에 추가하십시오:

{
  "mcpServers": {
    "servarr": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "SONARR_URL", "-e", "SONARR_API_KEY",
        "-e", "RADARR_URL", "-e", "RADARR_API_KEY",
        "-e", "PROWLARR_URL", "-e", "PROWLARR_API_KEY",
        "servarr-mcp"
      ],
      "env": {
        "SONARR_URL": "http://192.168.1.50:8989",
        "SONARR_API_KEY": "...",
        "RADARR_URL": "http://192.168.1.50:7878",
        "RADARR_API_KEY": "...",
        "PROWLARR_URL": "http://192.168.1.50:9696",
        "PROWLARR_API_KEY": "..."
      }
    }
  }
}

실행 중인 앱에 맞춰 -e 및 env 블록 패턴을 반복하십시오.

로컬 개발

npm install
cp .env.example .env  # then edit
SONARR_URL=... SONARR_API_KEY=... npm run dev

보안

컨테이너는 루트가 아닌 사용자(servarr)로 실행됩니다.
API 키는 환경 변수를 통해 전달되므로 이미지에 절대 포함하지 마십시오.
.githooks/pre-commit은 모든 커밋 시 gitleaks를 실행합니다. 복제본당 한 번 활성화하십시오: git config core.hooksPath .githooks.

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

servarr-mcp

servarr-mcp

도구

Sonarr (TV)

Radarr (영화)

Lidarr (음악)

Readarr (도서)

Prowlarr (인덱서 관리자)

구성

Docker로 실행

Claude Desktop과 함께 사용

로컬 개발

보안

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API