Plex MCP Server
MCP-сервер дает агенту Plex, Sonarr, Radarr и Trakt: библиотеку, статистику просмотров, рекомендации и очередь загрузок.
- 57 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Токен Plex открывает библиотеку и статистику просмотров других пользователей сервера, а HTTP-вариант не защищен аутентификацией.
- Включенные операции записи правят плейлисты и метаданные, а Sonarr и Radarr добавляют загрузки.
Установка
- Работает в
Ручная установка
npx plex-mcp-serverИз npm; задайте `PLEX_URL` и `PLEX_TOKEN` в конфигурации клиента.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен Plex открывает библиотеку и статистику просмотров других пользователей сервера, а HTTP-вариант не защищен аутентификацией.
- Включенные операции записи правят плейлисты и метаданные, а Sonarr и Radarr добавляют загрузки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер превращает домашний медиасервер Plex в источник данных для ассистента. Из коробки доступно 54 инструмента, при включенных операциях записи 66. Они листают библиотеки и ищут фильмы, показывают метаданные, плейлисты и список к просмотру, строят статистику просмотров в духе Tautulli: активность пользователей, популярное, история. Рекомендации опираются на историю, жанры, режиссеров и актеров, с профилями по пользователям многопользовательского сервера. Через Sonarr и Radarr агент ищет и добавляет сериалы и фильмы и смотрит очередь загрузок, а Trakt синхронизирует историю просмотров и обогащает рекомендации. Запуск: `npx plex-mcp-server`, обязателен только `PLEX_TOKEN`, остальные ключи по желанию.
Для кого. Владельцам домашнего Plex, которые ведут библиотеку с Sonarr, Radarr и Trakt и хотят спрашивать об этом ассистента простыми фразами.
Подходит, если
- Нужно спросить, что вы смотрели недавно и что лежит в списке «Продолжить просмотр».
- Хочется получить рекомендации по истории просмотров для конкретного пользователя сервера.
- Сериал надо добавить в Sonarr или посмотреть очередь загрузок голосом ассистента.
- История просмотров должна синхронизироваться с Trakt.
Не подходит, если
- Нельзя давать ассистенту токен Plex и доступ к истории других пользователей.
- HTTP-адрес сервера нельзя защитить: у него нет собственной аутентификации.
- Нужен только простой поиск по библиотеке без управления загрузками.
Пример запроса к агенту
Покажи, что я смотрел за последний месяц, и порекомендуй три фильма, которых я не видел.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
PLEX_TOKENобязательная, секрет- Токен доступа к серверу Plex.
PLEX_URLобязательная- Адрес сервера Plex, например http://localhost:32400.
SONARR_API_KEYсекрет- Ключ API Sonarr.
RADARR_API_KEYсекрет- Ключ API Radarr.
TRAKT_CLIENT_SECRETсекрет- Секрет приложения Trakt OAuth.
Ограничения
Нужны Node.js 20 и новее, сервер Plex и его токен; ключи Sonarr, Radarr и данные приложения Trakt нужны только для соответствующих инструментов, без них те возвращают понятную ошибку. Операции записи отключены по умолчанию: включайте их, только если доверяете решениям ассистента. HTTP-вариант слушает порт 3000 по пути `/mcp` без собственной аутентификации, и любой, кто до него дотянется, получает инструменты с вашим токеном Plex, поэтому оставляйте привязку к `127.0.0.1`. Токен храните вне репозитория и меняйте периодически. Статистика и рекомендации раскрывают просмотры других людей на сервере.
Как отключить. Уберите запись сервера из конфигурации клиента и остановите контейнер `plex-mcp`, если запускали Docker. Токены Plex, Sonarr, Radarr и Trakt при желании отзовите в их настройках.
Частые вопросы
Какие переменные обязательны?
Только `PLEX_TOKEN` (и адрес `PLEX_URL`, как в примере конфигурации). Остальные необязательны: `SONARR_URL`, `SONARR_API_KEY`, `RADARR_URL`, `RADARR_API_KEY`, `TRAKT_CLIENT_ID` и `TRAKT_CLIENT_SECRET`.
Как запустить в Docker?
Образ `ghcr.io/niavasha/plex-mcp-server:latest` слушает HTTP на порту 3000, MCP отдается по `/mcp`. Пробросьте порт только на `127.0.0.1`.
Как включить Trakt?
Создайте приложение Trakt OAuth с адресом возврата `urn:ietf:wg:oauth:2.0:oob`, добавьте идентификатор и секрет в конфигурацию и попросите ассистента пройти аутентификацию.
Сколько инструментов?
54 из коробки и 66 при включенных операциях записи.
Что делают операции записи?
Создают и правят плейлисты, меняют метаданные и управляют списком к просмотру. Они отключены по умолчанию.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыPlex MCP Server управляет библиотеками, плейлистами и воспроизведением Plex из Claude, ChatGPT и других клиентов MCP.
Личные ряды рекомендаций для каждого пользователя Plex, а через MCP агент настраивает их и запускает
MCP-сервер Spotify: агент ищет музыку, управляет воспроизведением, очередью и громкостью, собирает и правит плейлисты и медиатеку
DaVinci Resolve MCP
DaVinci Resolve MCP Server
MCP-сервер для управления DaVinci Resolve Studio через официальный Scripting API: монтаж, медиапул, рендер, грейдинг и Fusion
MCP-сервер управляет локальными проектами Adobe Premiere Pro из Claude, Codex и других MCP-клиентов
Transloadit MCP Server запускает Robots для видео, аудио, изображений и документов: обработка, шаблоны и проверка настроек.
Коротко о README
Сервер на TypeScript объединяет четыре сервиса в одном MCP. В описании разобраны установка из исходников, через npm и Docker, переменные окружения и получение токена Plex.