MCP Radarr and Sonarr Server

MCP Radarr and Sonarr サーバー

Radarr と Sonarr を統合して、メディアライブラリを管理する MCP サーバーです。

機能

現在の機能：

• 映画やテレビ番組のライブラリを閲覧
• 年やジャンルでメディアを検索、絞り込み
• 映画やテレビ番組のダウンロードをリクエスト
• ダウンロード状況や監視状況を確認
• システムの健全性を監視、管理
  • ディスク容量の監視
  • システムの健全性チェック
  • 状況のレポート

インストール

ローカルインストール

1. 依存関係をインストールします：

pnpm install

グローバルインストール

MCParr Server をシステムにグローバルインストールするには：

pnpm run install-global

これにより、ターミナルで mcparr コマンドをグローバルに使用できるようになります。

設定

1. 環境変数を設定します：

export RADARR_URL=http://your-radarr-instance:7878
export RADARR_API_KEY=your-radarr-api-key
export SONARR_URL=http://your-sonarr-instance:8989
export SONARR_API_KEY=your-sonarr-api-key

または、プロジェクトディレクトリにこれらの変数を記述した .env ファイルを作成できます。

使用方法

ローカルでの実行

サーバーをビルドして実行します：

pnpm run build
pnpm start

開発時：

pnpm run dev

グローバルでの実行

グローバルインストール済みの場合は、次のコマンドを実行するだけです：

mcparr

API リファレンス

search_media

フィルターを指定して映画やテレビ番組を検索します：

{
  mediaType: "movie" | "series",  // Required
  year?: number,                  // Optional
  genre?: string                  // Optional
}

request_download

特定のメディアのダウンロードをリクエストします：

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

check_status

特定のメディアの状況を確認します：

{
  mediaType: "movie" | "series",  // Required
  id: number                      // Required
}

get_system_status

システムの健全性とストレージ情報を取得します：

{
  system: "radarr" | "sonarr" | "both"  // Required - Which system to check
}

レスポンスには以下が含まれます：

• システムの状況（バージョン、稼働時間など）
• ディスク容量の情報
• 健全性チェックの結果

リソース

メディアは、次の URI スキームを使うリソースとして公開されます：

• 映画：radarr://movie/{id}
• テレビ番組：sonarr://series/{id}

各リソースには以下が含まれます：

• タイトル
• 年
• 現在の状況