plex-mcp

Сервер MCP для Plex Media Server, упакованный в виде Docker-контейнера. Позволяет MCP-клиенту (например, Claude Desktop) просматривать и искать ваши библиотеки Plex.

Инструменты

Related MCP server: Plex Assistant MCP

Конфигурация

Требуются две переменные окружения:

Чтобы найти свой токен Plex, обратитесь к руководству Plex Finding an authentication token.

Запуск с помощью Docker

docker build -t plex-mcp .
docker run -i --rm \
  -e PLEX_URL=http://192.168.1.50:32400 \
  -e PLEX_TOKEN=your-token \
  plex-mcp

Использование с Claude Desktop

Добавьте в ваш claude_desktop_config.json:

{
  "mcpServers": {
    "plex": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "PLEX_URL",
        "-e", "PLEX_TOKEN",
        "plex-mcp"
      ],
      "env": {
        "PLEX_URL": "http://192.168.1.50:32400",
        "PLEX_TOKEN": "your-token"
      }
    }
  }
}

Локальная разработка

npm install
cp .env.example .env  # then edit
PLEX_URL=... PLEX_TOKEN=... npm run dev

Безопасность

• Контейнер запускается от имени пользователя без прав root (plexmcp).

• Токен Plex передается через переменную окружения — никогда не вшивайте его в образ.

• Файл .githooks/pre-commit запускает gitleaks при каждом коммите. Активируйте его один раз для каждого клона: git config core.hooksPath .githooks