레이더 및 소나르 MCP 서버

클로드와 같은 AI 비서에게 Radarr(영화) 및 Sonarr(TV 시리즈) 데이터에 대한 액세스를 제공하는 Python 기반 모델 컨텍스트 프로토콜(MCP) 서버입니다.

개요

이 MCP 서버를 사용하면 AI 어시스턴트가 Radarr 및 Sonarr API를 통해 영화 및 TV 프로그램 컬렉션을 쿼리할 수 있습니다. FastMCP 기반으로 구축되었으며, Claude Desktop 및 기타 MCP 호환 클라이언트가 사용할 수 있는 AI 컨텍스트에 대한 표준화된 프로토콜을 구현합니다.

Related MCP server: Aider MCP Server

특징

• 네이티브 MCP 구현 : 원활한 AI 통합을 위해 FastMCP로 구축됨

• Radarr 통합 : 영화 컬렉션에 액세스하세요

• Sonarr 통합 : TV 프로그램 및 에피소드 데이터에 액세스하세요

• 풍부한 필터링 : 연도, 시청 상태, 배우 등으로 필터링

• Claude Desktop 호환 : Claude의 MCP 클라이언트와 원활하게 작동합니다.

• 간편한 설정 : 대화형 구성 마법사

• 철저한 테스트 : 신뢰성을 위한 포괄적인 테스트 모음

설치

출처에서

1. 이 저장소를 복제하세요:

   지엑스피1

2. 패키지를 설치하세요:

   pip install -e .

pip 사용 (곧 제공)

빠른 시작

1. 서버를 구성하세요:

   radarr-sonarr-mcp configure

   화면의 지시에 따라 Radarr/Sonarr API 키와 기타 설정을 입력하세요.

2. 서버를 시작합니다:

   radarr-sonarr-mcp start

3. Claude Desktop에 연결:

   • Claude Desktop에서 설정 > MCP 서버로 이동합니다.

   • URL: http://localhost:3000 (또는 구성된 포트)으로 새 서버를 추가합니다.

구성

구성 마법사가 다음을 설정하는 과정을 안내합니다.

• NAS/서버 IP 주소

• Radarr API 키 및 포트

• Sonarr API 키 및 포트

• MCP 서버 포트

config.json 파일을 수동으로 편집할 수도 있습니다.

사용 가능한 MCP 도구

이 서버는 Claude에게 다음과 같은 도구를 제공합니다.

영화 산업

• get_available_movies - 선택적 필터를 사용하여 영화 목록을 가져옵니다.

• lookup_movie - 제목으로 영화 검색

• get_movie_details - 특정 영화에 대한 자세한 정보를 가져옵니다.

시리즈

• get_available_series - 선택적 필터를 사용하여 TV 시리즈 목록을 가져옵니다.

• lookup_series - 제목으로 TV 시리즈 검색

• get_series_details - 특정 시리즈에 대한 자세한 정보를 가져옵니다.

• get_series_episodes - 특정 시리즈의 에피소드를 가져옵니다

자원

서버는 또한 표준 MCP 리소스를 제공합니다.

• /movies - 사용 가능한 모든 영화 찾아보기

• /series - 모든 시청 가능한 TV 시리즈를 탐색합니다.

필터링 옵션

대부분의 도구는 다양한 필터링 옵션을 지원합니다.

• year - 출시년도로 필터링

• watched - 시청 상태별 필터링(참/거짓)

• downloaded - 다운로드 상태별 필터링(참/거짓)

• watchlist - 관심목록 상태별 필터링(참/거짓)

• actors - 배우/캐스트 이름으로 필터링

• actresses - 여배우 이름으로 필터링(영화만 해당)

Claude에 대한 예제 쿼리

MCP 서버가 Claude Desktop에 연결되면 다음과 같은 질문을 할 수 있습니다.

• "2023년에 볼 수 있는 SF 영화는 뭐가 있을까?"

• "페드로 파스칼이 출연한 TV 프로그램을 보여주세요"

• "만달로리안의 보지 않은 에피소드가 있나요?"

• "아직 보지 않은 톰 행크스가 출연한 영화 찾아줘"

• "나는 Stranger Things 에피소드를 몇 개나 다운로드했을까?"

API 키 찾기

레이더 API 키

1. 브라우저에서 Radarr를 엽니다.

2. 설정 > 일반으로 이동하세요

3. "API 키" 섹션을 찾으세요

4. API 키 복사

Sonarr API 키

1. 브라우저에서 Sonarr을 엽니다.

2. 설정 > 일반으로 이동하세요

3. "API 키" 섹션을 찾으세요

4. API 키 복사

명령줄 인터페이스

이 패키지는 명령줄 인터페이스를 제공합니다.

• radarr-sonarr-mcp configure - 구성 마법사 실행

• radarr-sonarr-mcp start - MCP 서버 시작

• radarr-sonarr-mcp status - 현재 구성 표시

개발

테스트 실행

테스트 모음을 실행하려면:

지역 개발

빠른 개발 및 테스트를 위해:

요구 사항

• 파이썬 3.7 이상

• 패스트MCP

• 요청

• 피단틱

노트

• 감시/감시 목록 상태 기능은 Radarr/Sonarr의 특정 메커니즘을 사용하여 추적된다고 가정합니다. 사용자의 특정 설정에 맞게 이 기능을 조정해야 할 수도 있습니다.

• 보안상의 이유로 이 서버는 로컬 네트워크에서만 실행하는 것이 좋습니다.