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サーバー

Claude のような AI アシスタントに Radarr (映画) や Sonarr (TV シリーズ) データへのアクセスを提供する Python ベースの Model Context Protocol (MCP) サーバー。

概要

このMCPサーバーは、AIアシスタントがRadarrおよびSonarr APIを介して映画やテレビ番組のコレクションを照会できるようにします。FastMCPで構築されており、Claude Desktopやその他のMCP対応クライアントが使用できるAIコンテキストの標準化されたプロトコルを実装しています。

特徴

ネイティブMCP実装：シームレスなAI統合を実現するFastMCPで構築
Radarr 統合: 映画コレクションにアクセス
Sonarr 統合: テレビ番組やエピソードデータにアクセス
豊富なフィルタリング：年、視聴ステータス、俳優などでフィルタリング
Claudeデスクトップ互換: ClaudeのMCPクライアントとシームレスに動作します
簡単セットアップ：対話型構成ウィザード
十分にテスト済み: 信頼性のための包括的なテストスイート

インストール

ソースから

このリポジトリをクローンします:
git clone https://github.com/yourusername/radarr-sonarr-mcp.git cd radarr-sonarr-mcp-python
パッケージをインストールします。
pip install -e .

pip の使用（近日公開）

pip install radarr-sonarr-mcp

クイックスタート

サーバーを構成します。
radarr-sonarr-mcp configure
プロンプトに従って、Radarr/Sonarr API キーやその他の設定を入力します。
サーバーを起動します。
radarr-sonarr-mcp start
Claude Desktop に接続:
- Claudeデスクトップで、[設定] > [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 - オプションのフィルターを使用してテレビシリーズのリストを取得します
lookup_series - タイトルでテレビシリーズを検索する
get_series_details - 特定のシリーズに関する詳細情報を取得する
get_series_episodes - 特定のシリーズのエピソードを取得する

リソース

サーバーは標準の MCP リソースも提供します。

/movies - 利用可能なすべての映画を閲覧する
/series - 利用可能なすべてのテレビシリーズを閲覧

フィルタリングオプション

ほとんどのツールはさまざまなフィルタリングオプションをサポートしています。

year - リリース年でフィルタリング
watched - 監視ステータスでフィルタリング（true/false）
downloaded - ダウンロードステータスでフィルタリング（true/false）
watchlist - ウォッチリストのステータスでフィルタリング（true/false）
actors - 俳優/キャスト名でフィルタリング
actresses - 女優名で絞り込む（映画のみ）

クロードのクエリ例

MCP サーバーが Claude Desktop に接続されると、次のような質問をすることができます。

「2023年のSF映画にはどんなものがあるの？」
「ペドロ・パスカルが出演するテレビ番組を表示」
「『マンダロリアン』の未視聴のエピソードはありますか？」
「トム・ハンクスが出演しているまだ見ていない映画を探す」
「ストレンジャー・シングスのエピソードをいくつダウンロードしましたか？」

APIキーの検索

Radarr 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

要件

Python 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 を介して映画やテレビ番組のコレクションにアクセスし、クエリを実行できるようにする Python ベースのモデルコンテキストプロトコルサーバーです。

Related Resources

Reddit Discussion about this server

Radarr and Sonarr MCP Server