Plex MCP

🚀 Plex MCP サーバー

このサーバーは Python ベースの MCP サーバーで、Plex メディアサーバー API と統合されており、映画の検索や再生リストの管理を行うことができます。PlexAPI ライブラリを使用して、Plex サーバーとのシームレスなやり取りを実現しています。

✨ 主な機能

• Plex ライブラリ内の映画を検索することができます。
• 特定の監督の作品を検索し、欠けている映画を見つけることができます。
• 検索した映画を使って、新しい再生リストを作成することができます。

📦 インストール

前提条件

• Python 3.8 以上
• uv パッケージマネージャー
• API アクセス権を持つ Plex メディアサーバー

インストール方法

Smithery を使用した自動インストール

Smithery を通じて、Claude デスクトップに Plex メディアサーバー統合を自動でインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @djbriane/plex-mcp --client claude

手動インストール

1. このリポジトリをクローンします。

   git clone <repository-url>
   cd plex-mcp
   

2. uv を使用して依存関係をインストールします。

   uv venv
   source .venv/bin/activate
   uv install
   

3. サーバーを起動します。

   uv run python src/main.py
   

📚 ドキュメント

設定

環境変数

.env ファイルを作成し、以下の内容を追加します。

PLEX_SERVER_URL=https://your-plex-server-url:32400
PLEX_TOKEN=yourPlexTokenHere

使用方法

サーバーを起動した後、API または Web インターフェイスを通じて Plex とやり取りすることができます。

コマンド一覧

以下は、Plex MCP サーバーがサポートする主なコマンドです。

統合テスト

エンドツーエンドテスト

プロジェクトのルートディレクトリで以下のコマンドを実行して、エンドツーエンドテストを実行します。

uv run pytest tests/

統合テスト

統合テストを実行するには、まず Plex 設定を含む .env ファイルを作成し、以下のコマンドを実行します。

uv run pytest -m integration

コードスタイルと規約

• モジュール構造： インポート、ログ設定、ユーティリティ関数、クラス定義、グローバルヘルパー、および主な実行部分（if __name__ == "__main__": で保護された部分）を明確なセクションタイトルで区別します。
• 命名規則： クラスは CamelCase を使用し、関数、変数、fixture は lower_snake_case を使用します。テストでは、組み込みの fixture（例：monkeypatch）をカスタム fixture の前に配置します。
• ドキュメントとコメント： 各モジュール、クラス、関数には簡潔な docstring を含め、複雑なロジックにはインラインコメントを追加します。
• エラー処理とロギング： Python の logging モジュールを使用し、一貫したエラーメッセージ（「ERROR:」で始まる）と明示的な例外処理を行います。
• 非同期モード： I/O バインド関数は非同期として定義し、ブロッキング操作を処理する際には asyncio.to_thread() を使用します。

スクリーンショット

以下は、Plex MCP サーバーの実行例のいくつかのスクリーンショットです。

1. 監督による Plex ライブラリ内の映画検索

監督の名前を指定して、Plex ライブラリ内の映画を検索します。例えば、「Alfred Hitchcock」を検索すると、あなたのライブラリ内の彼の映画のリストが返されます。

2. 特定の監督の欠けている映画の検索

特定の監督の作品のうち、あなたの Plex ライブラリにない映画を特定します。これにより、あなたのコレクションの空白を見つけることができます。

3. Plex ライブラリ内で再生リストを作成する

検索した映画を使用して、Plex ライブラリ内に新しい再生リストを作成します。これにより、あなたのライブラリを簡単に整理することができます。