Plex MCP Server
Plex MCP Server управляет библиотеками, плейлистами и воспроизведением Plex из Claude, ChatGPT и других клиентов MCP.
- 160 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен администратора Plex хранится в настройках клиента или `.env`.
- Есть инструменты удаления медиа, очистки корзины и запуска задач обслуживания.
Установка
- Работает в
Ручная установка
uvx plex-mcp-server --transport stdio --plex-url http://your-server:32400 --plex-token your-tokenПервый вариант установки из README, запуск без установки. Свой адрес и токен подставьте вместо примеров.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен администратора Plex хранится в настройках клиента или `.env`.
- Есть инструменты удаления медиа, очистки корзины и запуска задач обслуживания.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер для Plex отдает агенту управление медиатекой через API Plex. Инструменты разбиты на модули: библиотеки со статистикой и обновлением метаданных, поиск и сведения о медиа, списки просмотра, плейлисты (включая умные), коллекции, пользователи, активные сеансы, клиенты воспроизведения и обслуживание сервера. Через клиентов можно запускать, ставить на паузу и перематывать воспроизведение, менять звуковую дорожку и субтитры. Для администратора есть чтение журналов Plex, статистика трафика и запуск задач планировщика. Транспорт: stdio, SSE и Streamable HTTP. Для удаленных клиентов вроде Claude.ai встроена авторизация OAuth.
Для кого. Владельцы домашнего сервера Plex, которые хотят наводить порядок в библиотеке и запускать фильмы голосом или текстом.
Подходит, если
- Нужно собрать умный плейлист по жанру и году.
- Агент проверяет, что нового добавилось в библиотеку.
- Запуск фильма на телевизоре с дивана одной фразой.
- Администратор смотрит нагрузку и журналы сервера.
Не подходит, если
- Плеер и библиотека делятся с чужими людьми без OAuth.
- Токен Plex нельзя хранить в настройках клиента.
- Агенту нельзя давать права на удаление медиа.
Пример запроса к агенту
Покажи, что добавилось в библиотеку фильмов за неделю, и собери из новинок плейлист на вечер без удаления чего-либо.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
`PLEX_URL`обязательная- Адрес сервера Plex, например `http://localhost:32400`.
`PLEX_TOKEN`обязательная, секрет- Токен аутентификации Plex.
`MCP_OAUTH_ENABLED`- Включает OAuth 2.1 для удаленных клиентов, по умолчанию выключен.
Ограничения
Серверу нужны адрес Plex и токен администратора, и токен лежит в настройках клиента или в `.env`, так что храните файл закрытым. Без OAuth каждый, кто достучится до порта, пользуется инструментами. Среди них есть удаление медиа, очистка корзины, оптимизация базы и запуск задач планировщика: подтверждайте такие вызовы вручную. Для Claude.ai и ChatGPT нужен публичный адрес с HTTPS и внешний провайдер OAuth, сервер сам не создает DNS и сертификат.
Как отключить. Удалите запись сервера из настроек клиента, остановите контейнер или процесс и сбросите токен Plex в аккаунте.
Частые вопросы
Как передать адрес и токен Plex?
Тремя способами: аргументами `--plex-url` и `--plex-token`, переменными `PLEX_URL` и `PLEX_TOKEN` в `.env` либо в блоке сервера в настройках клиента.
Есть ли образ Docker?
Да, `ghcr.io/vladimir-tutin/plex-mcp-server:latest` для amd64 и arm64. Он запускается без root и работает через API Plex, папки с медиа подключать не нужно.
Как подключить Claude.ai?
Нужны публичный адрес с HTTPS, провайдер OAuth и переменные `MCP_OAUTH_ENABLED`, `MCP_OAUTH_ISSUER`, `MCP_OAUTH_AUDIENCE`. Адрес клиента: `/sse` или `/mcp`.
Какие транспорты поддерживаются?
stdio, SSE и Streamable HTTP; в контейнере по умолчанию работает потоковый HTTP на порту 3001.
Какие операции опасны?
Удаление медиа, `server_empty_trash`, `server_optimize_database` и `server_run_butler_task`. Подтверждайте такие вызовы вручную.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер дает агенту Plex, Sonarr, Radarr и Trakt: библиотеку, статистику просмотров, рекомендации и очередь загрузок.
Личные ряды рекомендаций для каждого пользователя Plex, а через MCP агент настраивает их и запускает
MCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
MCP-сервер управляет локальными проектами Adobe Premiere Pro из Claude, Codex и других MCP-клиентов
MCP-сервер RunAPI: каталог из 160 моделей для изображений, видео, музыки и речи, цены, запуск задач и баланс
MCP-сервер видеостудии 37Studio: агент ведет бренды, делает ролики, публикует в соцсети и отвечает на сообщения.
Коротко о README
Сервер управляет Plex через его API и работает локально по stdio либо по сети с OAuth 2.1. Установка идет через `uvx`, `pip` или готовый образ Docker.