MCP Arr

🚀 MCP *arr Server

*[arrメディア管理スイート（Sonarr、Radarr、Lidarr、Readarr、Prowlarr）用のMCPサーバーです。]

🚀 クイックスタート

MCP *arr Serverは、*arrメディア管理スイート（Sonarr、Radarr、Lidarr、Readarr、Prowlarr）用のMCPサーバーです。以下の手順でセットアップして利用できます。

✨ 主な機能

• 統合メディア管理 - 1つのインターフェースからすべての*arrアプリケーションを制御できます。
• 自然言語クエリ - ライブラリに関する質問を平文で行えます。
• クロスサービス検索 - テレビ番組、映画、音楽、書籍を同時に検索できます。
• ダウンロード監視 - すべてのサービスのキューの状態と進捗を確認できます。
• カレンダー統合 - すべてのメディアタイプの今後のリリースを確認できます。
• 設定レビュー - AIによる設定最適化の提案を受け取れます。
• 柔軟な設定 - 使用するサービスのみを有効にできます。

📦 インストール

npmを使用する場合（推奨）

npx mcp-arr-server

ソースからインストールする場合

git clone https://github.com/aplaceforallmystuff/mcp-arr.git
cd mcp-arr
npm install
npm run build

📚 ドキュメント

APIキーの取得

各*arrアプリケーションのAPIキーは、設定 > 全般 > セキュリティで取得できます。

1. *arrアプリケーションのWebインターフェースを開きます。
2. 設定 > 全般に移動します。
3. セキュリティセクションでAPIキーを見つけます。
4. 設定で使用するためにAPIキーをコピーします。

Claude Desktop用の設定

Claude Desktopの設定ファイルに以下を追加します。 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "LIDARR_URL": "http://localhost:8686",
        "LIDARR_API_KEY": "your-lidarr-api-key",
        "READARR_URL": "http://localhost:8787",
        "READARR_API_KEY": "your-readarr-api-key",
        "PROWLARR_URL": "http://localhost:9696",
        "PROWLARR_API_KEY": "your-prowlarr-api-key"
      }
    }
  }
}

Claude Code用の設定

~/.claude.jsonに以下を追加します。

{
  "mcpServers": {
    "arr": {
      "command": "npx",
      "args": ["-y", "mcp-arr-server"],
      "env": {
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key"
      }
    }
  }
}

注意: 実行中のサービスのみを設定してください。サーバーは、提供する環境変数に基づいて利用可能なサービスを自動的に検出します。

💻 使用例

ライブラリ管理

• "Show me all my TV series" → すべてのテレビシリーズを表示してください
• "What movies do I have in Radarr?" → Radarrにある映画を教えてください
• "List all artists in my music library" → 音楽ライブラリのすべてのアーティストを一覧表示してください
• "How many books do I have by Stephen King?" → スティーブン・キングの本はいくつありますか

コンテンツの検索

• "Search for Breaking Bad on Sonarr" → Sonarrでブレイキング・バッドを検索してください
• "Find the movie Inception" → 映画「インセプション」を探してください
• "Search for Taylor Swift albums" → テイラー・スウィフトのアルバムを検索してください
• "Look up books by Brandon Sanderson" → ブランドン・サンダーソンの本を探してください

ダウンロードキュー

• "What's downloading right now?" → 現在ダウンロード中のものは何ですか
• "Check the Sonarr queue" → Sonarrのキューを確認してください
• "Show Radarr download progress" → Radarrのダウンロード進捗を表示してください

今後のリリース

• "What TV episodes are coming this week?" → 今週公開されるテレビエピソードを教えてください
• "Show upcoming movie releases" → 今後公開される映画を表示してください
• "Any new albums coming out this month?" → 今月公開される新しいアルバムはありますか
• "Show me upcoming book releases" → 今後公開される書籍を表示してください

コンテンツのダウンロード

• "What episodes of Severance am I missing?" → 「セバレンス」の欠落しているエピソードは何ですか
• "Download the missing episodes for that show" → その番組の欠落しているエピソードをダウンロードしてください
• "Search for this specific movie" → この特定の映画を検索してください
• "Grab that Japanese Breakfast album" → そのJapanese Breakfastのアルバムを取得してください
• "Download all missing books by Brandon Sanderson" → ブランドン・サンダーソンの欠落しているすべての本をダウンロードしてください

インデクサー管理

• "Are my indexers healthy?" → インデクサーは正常ですか
• "How are my indexers performing?" → インデクサーのパフォーマンスはどうですか
• "Test all my Prowlarr indexers" → すべてのProwlarrインデクサーをテストしてください

設定レビュー (NEW)

• "Review my Sonarr setup and suggest improvements" → Sonarrの設定をレビューし、改善案を提案してください
• "Show me my quality profiles in Radarr" → Radarrの品質プロファイルを表示してください
• "Are there any health issues with my Lidarr?" → Lidarrにヘルス上の問題はありますか
• "What naming convention am I using for TV shows?" → テレビ番組の命名規則は何ですか
• "Help me understand my quality profiles - why am I not getting 4K?" → 品質プロファイルを理解してください - なぜ4Kが取得できないのですか
• "Check my download client configuration" → ダウンロードクライアントの設定を確認してください
• "How much free space do I have on my root folders?" → ルートフォルダの空き容量はどれくらいですか

クロスサービス

• "Check status of all my arr services" → すべてのarrサービスのステータスを確認してください
• "Search for 'The Office' across all services" → すべてのサービスで「ザ・オフィス」を検索してください

利用可能なツール

一般的なツール

Sonarrツール (TV)

Radarrツール (Movies)

Lidarrツール (Music)

Readarrツール (Books)

Prowlarrツール (Indexers)

設定レビューツール

これらのツールは、Sonarr、Radarr、Lidarr、Readarrで利用できます。{service}をサービス名（例: sonarr_get_quality_profiles）に置き換えてください。

{service}_review_setupツールは、すべての設定を1回の呼び出しで返し、設定の最適化に関する自然言語会話を可能にします。Claudeは品質プロファイルを分析し、改善案を提案し、特定のコンテンツが取得できない理由を説明し、カスタムフォーマットなどの複雑な設定の構成を支援します。

⚠️ 重要提示

設定レビューツールは、*arr設定への読み取り専用アクセスを提供します。設定の変更は、*arrアプリケーションのインターフェースで直接行う必要があります。AIの提案は単なる推奨事項であり、重大な変更を行う前に常に設定をバックアップしてください。メンテナーは、AIによって生成された推奨事項に従ったことによって生じる設定の変更、データの損失、またはその他の問題について責任を負いません。

TRaSH Guidesツール

TRaSH Guidesからコミュニティで作成された品質プロファイル、カスタムフォーマット、命名規則に直接アクセスできます。これらのツールは、*arrの設定なしで動作し、TRaSH GuidesのGitHubリポジトリから参照データを取得します。

使用例:

• "What quality profiles does TRaSH recommend for 4K movies?" → TRaSHは4K映画にどの品質プロファイルを推奨していますか
• "Show me the remux-web-1080p profile details" → remux-web-1080pプロファイルの詳細を表示してください
• "Compare my Radarr profile 4 against the TRaSH uhd-bluray-web profile" → 私のRadarrプロファイル4をTRaSHのuhd-bluray-webプロファイルと比較してください
• "What naming convention should I use for Plex?" → Plexではどの命名規則を使用すべきですか
• "List HDR-related custom formats for Radarr" → RadarrのHDR関連のカスタムフォーマットを一覧表示してください

データは1時間キャッシュされ、GitHub APIの呼び出しを最小限に抑えます。

開発

# 開発用のウォッチモード
npm run watch

# TypeScriptのビルド
npm run build

# ローカルで実行
SONARR_URL="http://localhost:8989" SONARR_API_KEY="your-key" node dist/index.js

トラブルシューティング

"No *arr services configured"

少なくとも1組のURLとAPI_KEY環境変数を設定していることを確認してください。

SONARR_URL="http://localhost:8989"
SONARR_API_KEY="your-api-key"

"API error: 401 Unauthorized"

APIキーが正しくありません。*arrアプリケーションの設定 > 全般 > セキュリティで確認してください。

"fetch failed" or "ECONNREFUSED"

*arrアプリケーションが実行されていないか、URLが正しくありません。以下を確認してください。

• アプリケーションが実行されていること
• URLとポートが正しいこと
• 接続をブロックするファイアウォールがないこと

"Sonarr/Radarr/etc not configured"

設定されていないサービスのツールを使用しようとしました。対応するURLとAPI_KEY環境変数を追加してください。

コントリビューション

コントリビューションは大歓迎です！ガイドラインについてはCONTRIBUTING.mdを参照してください。

📄 ライセンス

MIT - 詳細はLICENSEを参照してください。

リンク

• Servarr Wiki - すべての*arrアプリケーションのドキュメント
• TRaSH Guides - 品質プロファイル、カスタムフォーマット、およびセットアップガイド
• Sonarr API Docs
• Model Context Protocol
• GitHub Repository