Gptdarr

🚀 GPTDARR - メディアセンター管理ツール（Sonarr & Radarr 統合版）

GPTDARRは、モデルコンテキストプロトコル（MCP）に基づく人工知能サーバーツールです。SonarrとRadarrとの統合に特化して設計されており、AIアシスタントがあなたのメディアライブラリ内でテレビ番組や映画の検索、追加、管理を行うのを支援します。

✨ 主な機能

• SonarrとRadarr内のテレビ番組と映画を検索する
• テレビ番組をSonarrに追加する
• 映画をRadarrに追加する
• デバッグと監視に使用する包括的なログシステム（現在は初期段階のプロジェクトです）

⚠️ 現在の制限

• 映画の処理に適しており、テレビ番組の機能は限られています
• 単一のシーズンとエピソードファイルのチェックはサポートされていません
• 監視状態の切り替えは未実装です（未監視の項目は無視されます）
• ツールの誤使用を防ぐため、ツールが正常に動作していることを確認してください

📋 待办事項

• [ ] 単一のシーズンとエピソードファイルのチェック機能を実装する
• [ ] 監視状態の切り替えのサポートを追加する
• [ ] テレビ番組の処理機能を向上させ、映画の機能と同等にする
• [ ] 自然言語での品質設定ファイルの上書きを許可する
• [ ] ツールの名前と説明を改善し、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）で：

   • ツール > 新規 > コマンドに移動します
   • コピーしたコマンドを貼り付けます
   • チャットクライアントがGPTDarr MCPサーバーと通信できるようになります

5. ⚠️ 重要な注意事項：システムプロンプト

   • 設定完了後、llm_system_prompt.txtにあるシステムプロンプトを使用してください
   • このプロンプトには、AIアシスタントがRadarrとSonarrとやり取りするための重要な指示が含まれています
   • このプロンプトにより、テレビ番組と映画のリクエストの一貫した処理、状態報告、コンテンツ管理の効率化が保証されます

サーバーが提供するツールは以下の通りです：

• lookup-content: テレビ番組と映画を検索する

  • パラメータ：
    • title: 検索するコンテンツのタイトル
    • year（オプション）：検索を絞り込むための公開年

• add-series: テレビ番組をSonarrに追加する

  • パラメータ：
    • items: 追加するTVシリーズのリスト。各シリーズには以下が含まれます：
      • seriesName: シリーズ名
      • seriesYear（オプション）：シリーズの年

• add-movies: 映画をRadarrに追加する

  • パラメータ：
    • items: 追加する映画のリスト。各映画には以下が含まれます：
      • title: 映画のタイトル
      • year（オプション）：映画の年

📝 ログ記録

ログは主に開発用であり、設定時に無効にすることをおすすめします。

• コンテンツ検索の記録
• シリーズと映画の追加記録
• その他の操作ログ

ログファイルはデフォルトのパスに保存されます。

📚 ドキュメント

GPTDARRはMCPプロトコルに基づくメディア管理ツールであり、AIと自動化によってメディアライブラリの管理効率を向上させることを目的としています。