MCP-сервер для управления библиотеками Plex, медиа и воспроизведения из Claude, ChatGPT и других MCP-клиентов.

Особенности

• JSON-ответы: Структурированные результаты для операций Plex.
• Multiple Transports: поддерживает stdio, SSE (события, отправляемые сервером) и потоковый HTTP.
• Комплексный контроль: Управление библиотеками, носителями, коллекциями, плейлистами, клиентами и пользователями.
• Remote Ready: встроенная поддержка OAuth 2.1 для интеграции с удалёнными AI-платформами, такими как Claude.ai.
• Инструменты администратора: доступ к журналам, мониторинг пропускной способности и выполнение задач Батлера.

Установка

Вариант 1: Использование УФ (Рекомендуемо)

Запускайте напрямую без установки:

Вариант 2: Установка через pip

Вариант 3: Разработка / Источник

Вариант 4: Docker

Опубликованное изображение — ghcr.io/vladimir-tutin/plex-mcp-server:latest для Linux AMD64 и ARM64. Он работает как некорневый пользователь и обслуживает Streamable HTTP по адресу /mcp. и устаревший SSE в /sse. Не требуется монтировать папки медиа: используется API Plex.

Следите за настройками Docker ниже, затем смотрите Публичный HTTPS-доступ для размещённых клиентов, таких как Claude.ai или ChatGPT.

Docker Compose

Редактировать .env перед началом. Например, для доверенного локального развертывания:

Замените '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