plex-mcp

Un servidor MCP para Plex Media Server, empaquetado como un contenedor Docker. Permite que un cliente MCP (Claude Desktop, etc.) explore y busque en tus bibliotecas de Plex.

Herramientas

Related MCP server: Plex Assistant MCP

Configuración

Dos variables de entorno, ambas obligatorias:

Para encontrar tu token de Plex, consulta la guía de Plex sobre Cómo encontrar un token de autenticación.

Ejecutar con 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

Usar con Claude Desktop

Añade esto a tu 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"
      }
    }
  }
}

Desarrollo local

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

Seguridad

• El contenedor se ejecuta como un usuario no root (plexmcp).

• El token de Plex se pasa a través de una variable de entorno; nunca lo incorpores en la imagen.

• Un .githooks/pre-commit ejecuta gitleaks en cada commit. Actívalo una vez por clonación: git config core.hooksPath .githooks