Plex MCP Server

Plex MCP Server

Claude を使って Plex のメディアライブラリを検索、管理できます。主に音楽を楽しむために Plex を使っている、詳しいことはあまり分からないけれど、どこまでできるか試してみたかった人間と Claude が積極的に開発しています。結果はさまざまですが、おそらく良い方向に向かうでしょう。

クイックスタート

Smithery 経由でインストール（推奨）

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

Claude Desktop の手動セットアップ

Claude Desktop の MCP 設定に追加します：

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

認証

オプション 1：OAuth（推奨）

• authenticate_plex ツールを使ってログイン URL を取得します
• ブラウザーからサインインします

オプション 2：静的トークン

• env セクションに "PLEX_TOKEN": "your_token" を追加します
• トークンは Plex Support から取得します

注： your-plex-server:32400 を実際の Plex サーバーアドレスとポートに置き換えてください。

HTTP デバッグログ

接続の問題をトラブルシューティングするには、HTTP リクエスト／レスポンスの詳細なログ記録を有効にできます：

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400",
        "MCP_HTTP_DEBUG": "true"
      }
    }
  }
}

MCP_HTTP_DEBUG=true の場合、サーバーは次の情報をログに記録します：

• リクエストの詳細： メソッド、URL、ヘッダー、パラメーター、所要時間
• レスポンスの詳細： ステータスコード、ヘッダー、レスポンスサイズ、所要時間
• エラー診断： 接続の詳細、TLS/SSL 証明書情報、トラブルシューティングの提案
• パフォーマンス指標： DNS ルックアップ、TCP 接続、TLS ハンドシェイクの所要時間
• セキュリティ： 機密性の高いヘッダー（トークン、認証情報など）はすべて自動的にマスキングされます

すべてのログは、リクエスト／レスポンスを追跡するための相関 ID を含む構造化 JSON です。

できること

検索と閲覧

• 映画、テレビ番組、音楽などのコンテンツを検索します
• ライブラリやコレクションを閲覧します
• 最近追加されたコンテンツや視聴履歴を確認します

音楽の探索

• 自然言語で音楽を探索します（「90 年代の曲」「まだ聴いたことのないロックバンド」など）
• リスニング傾向に基づいたスマートなおすすめ
• 多様性と意外性を生むインテリジェントなランダム化
• 類似アーティストの探索やジャンルの検索

プレイリスト

• プレイリストを作成、管理します
• 既存のプレイリストにアイテムを追加します
• プレイリストの内容を閲覧します

メディア情報

• 詳細なメディア情報（コーデック、ビットレート、ファイルサイズなど）を取得します
• 視聴状況と進捗を確認します
• ライブラリの統計情報やリスニング統計を表示します

リソース（データアクセス）

• URI を使って構造化データにアクセスします：plex://libraries、plex://recent、plex://playlists
• ライブラリ固有のデータ：plex://library/{id}、plex://library/{id}/recent
• サーバーの統計情報と接続状態
• 分析や自動化に使える JSON 形式のデータ

プロンプト（AI アシスタンス）

• playlist_description： 創造的なプレイリストの説明を生成します
• content_recommendation： パーソナライズされたコンテンツのおすすめを取得します
• smart_playlist_rules： スマートプレイリストの条件とルールを作成します
• media_analysis： ライブラリのコンテンツと傾向を分析します
• server_troubleshooting： サーバーの接続問題を診断します

ステータス

✅ 動作中： 検索、閲覧、プレイリスト、メディア情報、ライブラリ統計、視聴履歴、コレクション、音楽の探索、リソース、プロンプト

❌ 無効： スマートプレイリスト（フィルターのロジックに不具合があります）

🚧 予定： リモートサーバーの閲覧

開発

貢献したいですか？ローカル版を Claude に指定してください：

{
  "mcpServers": {
    "plex-dev": {
      "command": "node",
      "args": ["/path/to/plex-mcp/index.js"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

私たちの環境では動作しています。お使いの環境で動かなくても、まあ、試してみました。気軽にご連絡ください。噛みついたりしません。たぶん。