レーダーとソナーMCPサーバー

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

概要

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

Related MCP server: Trakt

特徴

• ネイティブMCP実装：シームレスなAI統合を実現するFastMCPで構築

• Radarr 統合: 映画コレクションにアクセス

• Sonarr 統合: テレビ番組やエピソードデータにアクセス

• 豊富なフィルタリング：年、視聴ステータス、俳優などでフィルタリング

• Claudeデスクトップ互換: ClaudeのMCPクライアントとシームレスに動作します

• 簡単セットアップ：対話型構成ウィザード

• 十分にテスト済み: 信頼性のための包括的なテストスイート

インストール

ソースから

1. このリポジトリをクローンします:

   git clone https://github.com/yourusername/radarr-sonarr-mcp.git
   cd radarr-sonarr-mcp-python

2. パッケージをインストールします。

   pip install -e .

pip の使用（近日公開）

pip install radarr-sonarr-mcp

クイックスタート

1. サーバーを構成します。

   radarr-sonarr-mcp configure

   プロンプトに従って、Radarr/Sonarr API キーやその他の設定を入力します。

2. サーバーを起動します。

   radarr-sonarr-mcp start

3. 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キー

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 - 現在の設定を表示する

発達

テストの実行

テスト スイートを実行するには:

# 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の特定のメカニズムを使用して追跡されることを前提としています。お使いの設定に合わせて調整する必要がある場合があります。

• セキュリティ上の理由から、このサーバーはローカル ネットワーク上でのみ実行することをお勧めします。