Moviepilot MCP

🚀 MoviePilot - MCP プロジェクト概要

MoviePilot - MCP は、映画愛好者のために特別に設計された MCP（MCP はマルチパーパスコントロールパネルまたはその他の関連技術用語を指す可能性があります）サービスで、MoviePilot の API をベースに構築されています。このサービスは、ユーザーがメディアライブラリを管理し、ダウンロードリソースを検索し、ダウンロードタスクの状態を監視するための統一コンソールを提供することを目的としています。

✨ 主な機能

• 統一コンソール：すべてのメディア関連の操作を一箇所で管理および監視できます。
• スマート検索：正確および曖昧検索機能を通じて、必要な映画やテレビ番組を迅速に見つけることができます。
• 拡張性：柔軟に設計されており、将来的に SSE デプロイ方式を提供する予定です。
• セキュリティ：組み込みのセキュリティ対策により、環境とアカウントの安全を確保します。

📦 機能モジュール

1. メディアライブラリ管理

• メディアの追加：API を通じて新しいコンテンツをメディアライブラリに追加します。
• メディアの削除：不要になったコンテンツを削除します。
• メディアの検索：タイトル、年、またはカテゴリーで特定の映画やテレビ番組を検索します。

2. ダウンロードタスク制御

• ダウンロードの開始：新しいダウンロードタスクを開始します。
• 一時停止/再開：ダウンロード中のタスクを一時停止または再開します。
• タスクの削除：未完成のダウンロードタスクをキャンセルします。

3. リソース管理

• リソース検索：TMDB ID または豆瓣 ID を基に、ダウンロード可能なシードを検索します。
• 曖昧検索：キーワードでリソースを検索します。
• 履歴記録：過去のダウンロード記録を確認します。

🔧 開発状況

現在、プロジェクトは機能を段階的に導入している段階にあります。将来的な計画には、サービスの拡張性とパフォーマンスを強化するための SSE デプロイ方式の提供が含まれています。

⚠️ セキュリティに関する注意事項

• 環境の安全性：MoviePilot アカウント情報を保存する環境が安全であることを確認してください。
• アカウントの安全性：この MCP サーバーには専用のアカウントを作成することをおすすめします。管理者アカウントの使用は避けてください。

🚀 開発ガイド

前提条件

• オペレーティングシステム：Python 3.12 以上の環境
• ツール：uv パッケージマネージャー
• インフラストラクチャ：稼働中でアクセス可能な MoviePilot サービスインスタンス

設定手順

1. リポジトリのクローン：

   git clone https://github.com/Pollo3470/MoviePilot-MCP
   cd MoviePilot-MCP
   

2. 設定ファイルの作成：

   • .env.example ファイルをコピーして .env という名前に変更します。
   • 必要な設定情報を記入します。例えば：

     # .env の例
     MOVIEPILOT_BASE_URL=http://your-moviepilot-ip:3000  # あなたの MoviePilot のアドレス
     
     # 認証方式の設定
     MOVIEPILOT_USERNAME=your_moviepilot_username  # あなたの MoviePilot ユーザー名（パスワード認証用）
     MOVIEPILOT_PASSWORD=your_moviepilot_password  # あなたの MoviePilot パスワード（パスワード認証用）
     

3. 開発環境の作成：

   uv sync
   

👥 貢献

コミュニティからの貢献を歓迎します！バグを見つけた場合や機能提案がある場合は、リポジトリの Issues を通じて提出してください。あなたの貢献により、プロジェクトが改善されます。

🙏 謝辞

この MCP サービスの開発を可能にした MoviePilot プロジェクトの技術サポートに感謝します。

📄 ライセンス

このプロジェクトは [LICENSE] ライセンスに従っており、詳細はプロジェクトの LICENSE ファイルを参照してください。