Plexライブラリ、メディア、Claude、ChatGPT、その他のMCPクライアントからの再生を管理するMCPサーバーです。

特徴

• JSON レスポンス:Plex操作の構造化された結果。
• マルチプルトランスポート:stdio、SSE(サーバー送信イベント)、ストリーム可能なHTTPをサポートします。
• 包括的な管理:ライブラリ、メディア、コレクション、プレイリスト、クライアント、ユーザーを管理。
• Remote Ready:Claude.ai のようなリモートAIプラットフォームとの統合のための組み込みOAuth 2.1サポート。
• 管理ツール:ログへのアクセス、帯域幅の監視、バトラータスクの実行。

設置

オプション1:UVの使用(推奨)

インストールなしで直接実行:

オプション2:pip経由でインストール

オプション3:開発/出典

オプション4:Docker

公開されているイメージはLinux用のghcr.io/vladimir-tutin/plex-mcp-server:latestです amd64およびarm64です。非rootユーザーとして動作し、[[T2]でStreamable HTTPを提供しています。 そしてレガシーSSEは/sseに配置されています。メディアフォルダのマウントは不要で、PlexのAPIを使用しています。

下のDockerセットアップに従ってください。その後、こちらをご覧ください Claude.ai やChatGPTなどのホストクライアント向けの公開HTTPSアクセス。

Docker Compose

開始前に.envを編集してください。例えば、信頼されたLAN展開の場合:

'192.168を置き換えてください。

Plex MCP Server

An MCP server for managing Plex libraries, media, and playback from Claude, ChatGPT, and other MCP clients.

Features

• JSON responses: Structured results for Plex operations.
• Multiple Transports: Supports stdio, SSE (Server-Sent Events), and Streamable HTTP.
• Comprehensive Control: Manage libraries, media, collections, playlists, clients, and users.
• Remote Ready: Built-in OAuth 2.1 support for integration with remote AI platforms like Claude.ai.
• Admin Tools: Access logs, monitor bandwidth, and run Butler tasks.

Installation

Option 1: Using uv (Recommended)

Run directly without installation:

uvx plex-mcp-server --transport stdio --plex-url http://your-server:32400 --plex-token your-token

Option 2: Install via pip

pip install plex-mcp-server

Option 3: Development / Source

git clone https://github.com/vladimir-tutin/plex-mcp-server.git
cd plex-mcp-server
pip install -e .

Option 4: Docker

The published image is ghcr.io/vladimir-tutin/plex-mcp-server:latest for Linux amd64 and arm64. It runs as a non-root user and serves Streamable HTTP at /mcp and legacy SSE at /sse. No media folders need to be mounted: it uses Plex’s API.

Follow the Docker setup below, then see Public HTTPS access for hosted clients such as Claude.ai or ChatGPT.

Docker Compose

git clone https://github.com/vladimir-tutin/plex-mcp-server.git
cd plex-mcp-server
cp .env.docker.example .env

Edit .env before starting. For a trusted LAN deployment, for example:

PLEX_URL=http://192.168.1.10:32400
PLEX_TOKEN=your-plex-token
MCP_BIND_ADDRESS=192.168.1.20
MCP_PUBLISHED_PORT=3001
MCP_SERVER_URL=http://192.168.1.20:3001
MCP_OAUTH_ENABLED=false

Replace 192.168.1.10 with the Plex address and 192.168.1.20 with the Docker host’s address. Without OAuth, anyone who can reach this port can use the tools. The supplied example file defaults to loopback (127.0.0.1) instead, for access from the Docker host only. Keep .env private.

docker compose pull
docker compose up -d --no-build
docker compose logs -f

The LAN example’s client URL is http://192.168.1.20:3001/mcp. Hosted clients need a reachable HTTPS endpoint; follow Public HTTPS access.

Other Docker deployments

Use ghcr.io/vladimir-tutin/plex-mcp-server:latest, publish container port 3001 (TCP), and set these environment variables:

Use your Docker host’s address and published port in MCP_SERVER_URL. MCP_BIND_ADDRESS and MCP_PUBLISHED_PORT only configure this repository’s Compose file; for other deployments, set the port mapping directly.

Public HTTPS access