mcpField
G
GPTDARR - Sonarr & Radarr MCP Server

GPTDARR - Sonarr & Radarr MCP Server

ローカル
github.com/csmit195ゲーム・エンタメ382 週間前に更新
リポジトリ

GPTDARR - Sonarr & Radarr MCP Server について

GPTDARR は Sonarr と Radarr を通じてメディアライブラリを管理する MCP サーバーです。AI アシスタントによる作品検索やシリーズ・映画の追加に対応し、対話型ウィザードで設定できます。

主な機能

  1. 01テレビ番組と映画の検索
  2. 02Sonarr へのシリーズ追加
  3. 03Radarr への映画追加
  4. 04対話型設定ウィザード
  5. 05リクエストとエラーのログ記録

活用シーン

  1. 01Sonarr または Radarr で作品を検索
  2. 02Sonarr にシリーズを追加
  3. 03Radarr に映画を追加

MCP 対応

MCP 対応チャットクライアントに、作品検索・シリーズ追加・映画追加のツールを公開し、設定済みの Sonarr と Radarr に接続します。

#gptdarr#sonarr#radarr#media-management#automation

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "gptdarr": {
      "command": "npx",
      "args": [
        "-y",
        "gptdarr"
      ]
    }
  }
}
起動コマンドnpx -y gptdarr

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmgptdarr

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

GPTDARR - Sonarr と Radarr の MCP サーバー

説明

GPTDARR は、Sonarr と Radarr を統合する Model Context Protocol（MCP）対応の AI ツールサーバーです。AI アシスタントがメディアライブラリ内のテレビ番組や映画を検索、追加、管理するのに役立ちます。

機能

  • Sonarr と Radarr でテレビ番組や映画を検索
  • テレビシリーズを Sonarr に追加
  • 映画を Radarr に追加
  • デバッグと監視のための包括的なログシステム（ログが多くてすみません。現在も開発中のアプリケーションです）

現在の制限事項

  • 映画で最もよく機能します。テレビ番組のサポートはより限定的です
  • シーズンやエピソードごとのファイルチェックには対応していません
  • 監視の切り替えは実装されていません（監視対象外の項目は無視されます）
  • ツールの使用方法を幻覚しやすいため、ツールが実行されることを確認してください。

TODO

  • シーズンやエピソードごとのファイルチェックを実装する
  • 監視状態の切り替えに対応する
  • テレビ番組のサポートを改善し、映画と同等の機能を実現する
  • 自然言語で品質プロファイルを上書きする
  • LLM がツール呼び出しを幻覚しないよう、ツール名と説明を改善する（専門家からのアドバイスをお待ちしています）
  • 幻覚を減らすため、LLM のシステムプロンプトを改善する（こちらについても専門家からのアドバイスをお待ちしています）

はじめに

前提条件
  • Node.js 18 以降
  • Sonarr と Radarr のセットアップと実行
  • MCP 対応のチャットクライアント（例：5ire、Claude）
インストールとセットアップ

  1. 対話型設定ウィザードを実行します。

    npx gptdarr setup

  2. ウィザードの案内に従って、以下を設定します。

    • Sonarr の URL と API キー
    • Radarr の URL と API キー
    • 両サービスの品質プロファイル
    • メディア保存用のルートフォルダー
    • ログの設定

  3. セットアップが完了すると、ウィザードが NPX コマンドを生成します（推奨）。このコマンドをコピーします。

  4. MCP 対応のチャットクライアント（例：5ire）で、次の操作を行います。

    • Tools > New > Command に移動します
    • コピーしたコマンドを貼り付けます
    • これでチャットクライアントから GPTDarr MCP サーバーを起動し、通信できるようになります

  5. 重要：システムプロンプト

    • ツールのセットアップ後、llm_system_prompt.txt にある提供済みのシステムプロンプトを必ず使用してください
    • このプロンプトには、AI アシスタントが Radarr と Sonarr を適切に操作するための重要な指示が含まれています
    • このプロンプトにより、映画やテレビ番組のリクエストへの一貫した対応、適切なステータス報告、効率的なコンテンツ管理が実現します

サーバーでは、以下のツールを利用できます。

  • lookup-content：テレビ番組や映画を検索します

    • パラメーター：
      • title：検索するタイトル
      • year（任意）：検索を絞り込むための公開年

  • add-series：テレビシリーズを Sonarr に追加します

    • パラメーター：
      • items：追加するテレビシリーズのリスト。それぞれ以下を指定します。
        • seriesName：テレビシリーズ名
        • seriesYear（任意）：テレビシリーズの年

  • add-movies：映画を Radarr に追加します

    • パラメーター：
      • items：追加する映画のリスト。それぞれ以下を指定します。
        • title：映画のタイトル
        • year（任意）：映画の公開年
ログ

ログは主に開発用のため、セットアップの実行中は無効にすることをおすすめします。

  • コンテンツ検索
  • シリーズや映画の追加
  • API リクエストとレスポンス
  • エラーと例外

ログはホームディレクトリ内の .gptdarr フォルダーに保存されます。

コントリビューション

コントリビューションを歓迎します。詳細については、コントリビューションガイドをお読みください。

ライセンス

このプロジェクトは MIT License の下でライセンスされています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。