remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to your movie collection data, allowing querying, filtering, and retrieving detailed information about movies in your Radarr library by year, watched status, actors, and other criteria.
Provides access to your TV series and episode data, enabling querying, filtering, and retrieving detailed information about TV shows and episodes in your Sonarr library by various criteria including watched status and cast.

레이더 및 소나르 MCP 서버

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

개요

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

특징

네이티브 MCP 구현 : 원활한 AI 통합을 위해 FastMCP로 구축됨
Radarr 통합 : 영화 컬렉션에 액세스하세요
Sonarr 통합 : TV 프로그램 및 에피소드 데이터에 액세스하세요
풍부한 필터링 : 연도, 시청 상태, 배우 등으로 필터링
Claude Desktop 호환 : Claude의 MCP 클라이언트와 원활하게 작동합니다.
간편한 설정 : 대화형 구성 마법사
철저한 테스트 : 신뢰성을 위한 포괄적인 테스트 모음

설치

출처에서

이 저장소를 복제하세요:지엑스피1
패키지를 설치하세요:
pip install -e .

pip 사용 (곧 제공)

pip install radarr-sonarr-mcp

빠른 시작

서버를 구성하세요:
radarr-sonarr-mcp configure
화면의 지시에 따라 Radarr/Sonarr API 키와 기타 설정을 입력하세요.
서버를 시작합니다:
radarr-sonarr-mcp start
Claude Desktop에 연결:
- Claude Desktop에서 설정 > MCP 서버로 이동합니다.
- URL: http://localhost:3000 (또는 구성된 포트)으로 새 서버를 추가합니다.

구성

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

NAS/서버 IP 주소
Radarr API 키 및 포트
Sonarr API 키 및 포트
MCP 서버 포트

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

{
  "nasConfig": {
    "ip": "10.0.0.23",
    "port": "7878"
  },
  "radarrConfig": {
    "apiKey": "YOUR_RADARR_API_KEY",
    "basePath": "/api/v3",
    "port": "7878"
  },
  "sonarrConfig": {
    "apiKey": "YOUR_SONARR_API_KEY",
    "basePath": "/api/v3",
    "port": "8989"
  },
  "server": {
    "port": 3000
  }
}

사용 가능한 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 키

브라우저에서 Radarr를 엽니다.
설정 > 일반으로 이동하세요
"API 키" 섹션을 찾으세요
API 키 복사

Sonarr API 키

브라우저에서 Sonarr을 엽니다.
설정 > 일반으로 이동하세요
"API 키" 섹션을 찾으세요
API 키 복사

명령줄 인터페이스

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

radarr-sonarr-mcp configure - 구성 마법사 실행
radarr-sonarr-mcp start - MCP 서버 시작
radarr-sonarr-mcp status - 현재 구성 표시

개발

테스트 실행

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

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov=radarr_sonarr_mcp

지역 개발

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

# Run directly without installation
python run.py

요구 사항

파이썬 3.7 이상
패스트MCP
요청
피단틱

노트

감시/감시 목록 상태 기능은 Radarr/Sonarr의 특정 메커니즘을 사용하여 추적된다고 가정합니다. 사용자의 특정 설정에 맞게 이 기능을 조정해야 할 수도 있습니다.
보안상의 이유로 이 서버는 로컬 네트워크에서만 실행하는 것이 좋습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Claude와 같은 AI 도우미가 Radarr 및 Sonarr API를 통해 영화 및 TV 프로그램 컬렉션에 액세스하고 쿼리할 수 있도록 하는 Python 기반 모델 컨텍스트 프로토콜 서버입니다.

Related Resources

Reddit Discussion about this server

Radarr and Sonarr MCP Server