Moviepilot MCP

MoviePilot MCPサーバーは、大規模言語モデルとMoviePilotメディアライブラリ管理システムを接続するプロトコルの実装で、自然言語での対話を通じてメディアの検索、購読管理、ダウンロード制御などの機能を実現します。

エンターテインメントとメディア家庭自動化とIoT #メディア管理 #自然言語対話 #自動化 #映画・テレビリソース .Python

スコア : 2.5ポイント

ダウンロード数 : 6.2K

更新時間 : 2025-04-29

サイトを開く

MoviePilot MCPサーバーとは？

これはスマートなメディア管理アシスタントで、日常会話のような形でMoviePilotメディアライブラリを制御できます。大規模言語モデル（ChatGPTなど）を接続することで、映画の検索、新しいドラマの購読、ダウンロードタスクの管理などを直接依頼したり命令したりできます。

MoviePilot MCPの使い方は？

MCPプロトコルをサポートするアプリ（Cherry Studioなど）にサーバー設定を追加し、自然言語でリクエストを送信するだけです。例えば、「『オッペンハイマー』のダウンロードリソースを探して」や「『最後の生き物』第2シーズンを購読する」などです。

適用シーン

音声やチャットでメディアライブラリを管理したいユーザーや、モバイルデバイスでメディアライブラリを素早く操作したいシーンに適しています。複雑な操作手順を覚える必要はありません。

主要機能

スマートメディア検索

タイトル、俳優、評価などの複数の次元で映画やテレビドラマを検索でき、豆瓣やTMDbから豊富な情報を取得できます。

購読管理

対話を通じてメディアの購読を追加、変更、削除でき、新しいリソースを自動的に監視してダウンロードします。

ダウンロード制御

ダウンロードの進捗状況を確認し、タスクを一時停止、再開、失敗したダウンロードを削除するなどができます。

メディアライブラリ照会

メディアがライブラリに存在するか確認し、最近追加された内容を表示し、再生状態を取得できます。

利点

自然言語での対話が可能で、複雑なインターフェースを学ぶ必要がありません。

複数のデータソース（豆瓣/TMDb）の豊富なメディア情報を統合しています。

発見からダウンロード、ライブラリへの登録までの全プロセスのメディア管理をサポートしています。

応答速度が速く、操作効率が高いです。

制限

安定したネットワーク接続が必要です。

一部の複雑な操作は依然としてウェブページで行う必要があります。

サードパーティのメディアデータソースの正確性に依存しています。

使い方

MCPクライアントを設定する

MCPをサポートするアプリ（Cherry Studioなど）にMoviePilot MCPサーバーの設定を追加します。

対話を開始する

チャット画面にメディア管理のリクエストを入力します。例えば： - 「『オッペンハイマー』を購読する」 - 「最近の新作映画を教えて」

結果を確認する

システムは見つかった結果や実行状態を返します。操作を確認するか、リクエストを変更することができます。

使用例

新しい映画を発見する

最近の人気の高い高評価映画を見つけてメディアライブラリに追加したい場合。

購読を管理する

既存のメディアの購読を確認して更新したい場合。

ダウンロードを制御する

ダウンロード速度が遅いタスクを処理したい場合。

よくある質問

事前に準備する必要があるものは何ですか？

どの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 サービスインスタンス

設定手順

リポジトリのクローン：

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

設定ファイルの作成：

.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 パスワード（パスワード認証用）