Plex MCP Server

🚀 Plex MCP Server

このサーバーは、Model Context Protocol (MCP) を利用して、AIアシスタントがPlexメディアサーバーにアクセスできるようにします。自然言語でライブラリの照会、視聴統計の取得、メディアの管理が可能です。

🚀 クイックスタート

前提条件

• Node.js 18以上
• Plexメディアサーバー（最近のバージョン）
• Plexトークン (Plexトークンの取得方法)
• MCP互換クライアント（Claude Desktopなど）

インストール

# リポジトリをクローン
git clone https://github.com/niavasha/plex-mcp-server.git
cd plex-mcp-server

# 依存関係をインストール
npm install

# プロジェクトをビルド
npm run build

設定

1. Plexトークンを取得（下記の手順を参照）
2. 環境ファイルを作成

# サンプル環境ファイルをコピー
cp .env.example .env

# 詳細を編集
PLEX_URL=http://localhost:32400
PLEX_TOKEN=your_plex_token_here

3. MCPクライアントを設定 MCPクライアントの設定（例：Claude Desktop）に追加します。

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

使用方法

設定が完了したら、AIアシスタントに以下のような質問をすることができます。

🎬 "先週見た映画は何ですか？"
📺 "今月最も人気のあるテレビ番組を教えて"
📊 "過去30日間の視聴統計を教えて"
🔍 "ライブラリ内のクリストファー・ノーランの映画を検索"
▶️ "続きを見るリストに何がありますか？"
📚 "すべてのPlexライブラリをリストアップ"

✨ 主な機能

📚 ライブラリ管理

• すべてのPlexライブラリを閲覧
• 映画、テレビ番組、音楽などを検索
• 任意のメディアアイテムの詳細メタデータを取得

📊 Tautulliスタイルの分析

• 包括的な視聴統計
• ユーザーアクティビティの追跡
• 人気コンテンツの分析
• 進行状況を追跡した視聴履歴
• ライブラリ使用メトリクス

🎯 スマートクエリ

• 最近視聴したコンテンツ
• 完全に視聴した映画/番組
• 続きを見る（On Deck）
• 最近追加されたメディア

💻 使用例

基本的な使用法

# 設定が完了したら、AIアシスタントに以下のような質問をすることができます。
🎬 "先週見た映画は何ですか？"

高度な使用法

# より詳細な統計や特定の条件での検索など、高度なシナリオでの使用例
📊 "過去30日間の特定のユーザーの視聴統計を教えて"

📚 ドキュメント

🛠️ 利用可能な関数

🔑 Plexトークンの取得方法

1. ブラウザで Plex Webアプリを開く
2. 設定に移動 → アカウント → プライバシー
3. 下部の "詳細を表示" をクリック
4. Plexトークンをコピー

別の方法：

• 以下のURLにアクセス：http://YOUR_PLEX_IP:32400/web/index.html#!/settings/account
• "Plexトークン" フィールドを探す

📁 プロジェクト構造

plex-mcp-server/
├── src/
│   └── index.ts          # メインのMCPサーバー実装
├── build/                # コンパイルされたJavaScript出力
├── package.json          # Node.jsの依存関係とスクリプト
├── tsconfig.json         # TypeScriptの設定
├── .env.example          # 環境変数のテンプレート
├── README.md             # このファイル
└── LICENSE               # MITライセンス

🔧 開発

スクリプト

# 自動リロードで開発モードを起動
npm run dev

# 本番用にビルド
npm run build

# 本番サーバーを起動
npm start

# テストを実行（実装されている場合）
npm test

ソースからビルド

# クローンしてセットアップ
git clone https://github.com/niavasha/plex-mcp-server.git
cd plex-mcp-server
npm install

# 開発
npm run dev

🐛 トラブルシューティング

一般的な問題

• 接続拒否：
  • Plexサーバーが実行中であることを確認
  • .env ファイル内の PLEX_URL を確認
  • ポート（通常は32400）が正しいことを確認
• 認証エラー：
  • Plexトークンが正しいことを確認
  • Plex設定内のトークンの権限を確認
  • トークンが期限切れになっていないことを確認
• 空の応答：
  • 一部の機能にはPlex Passが必要
  • ライブラリがアクセス可能であることを確認
  • メディアがスキャンされ、利用可能であることを確認
• MCPクライアントの問題：
  • build/index.js へのパスが正しいことを確認
  • Node.jsがシステムのPATHに含まれていることを確認
  • クライアント設定内の環境変数が設定されていることを確認

ヘルプの取得

• 📝 問題を報告
• 💬 既存のディスカッションを確認
• 📖 MCPドキュメントを確認

📋 要件

• Node.js 18.0.0以上
• Plexメディアサーバー（最近のバージョン）
• MCPサーバーとPlexサーバー間のネットワークアクセス
• 適切な権限を持つ有効なPlexトークン

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

• Plexトークンを安全に保管 - バージョン管理にコミットしないでください
• 環境変数を使用 して機密設定を管理
• 信頼できるネットワーク上で実行 - サーバーは直接Plexと通信するため
• 定期的なトークンの更新 - トークンを定期的に更新することを検討

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• Anthropic のModel Context Protocol
• Plex の素晴らしいメディアサーバー
• Tautulli の分析のインスピレーション
• 様々なライブラリやツールを提供するオープンソースコミュニティ

🔗 関連プロジェクト

• Model Context Protocol - このサーバーが実装する標準
• Claude Desktop - 人気のあるMCPクライアント
• Tautulli - Plexの監視と分析
• PlexAPI - PythonのPlex APIライブラリ

PlexとAIコミュニティのために愛を込めて作成されました