plex-mcp

Ein MCP-Server für den Plex Media Server, verpackt als Docker-Container. Ermöglicht es einem MCP-Client (Claude Desktop usw.), Ihre Plex-Bibliotheken zu durchsuchen und zu durchsuchen.

Tools

Related MCP server: Plex Assistant MCP

Konfiguration

Zwei Umgebungsvariablen, beide erforderlich:

Um Ihr Plex-Token zu finden, lesen Sie den Leitfaden von Plex zum Finden eines Authentifizierungs-Tokens.

Ausführen mit 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

Verwendung mit Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "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"
      }
    }
  }
}

Lokale Entwicklung

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

Sicherheit

• Der Container läuft als Nicht-Root-Benutzer (plexmcp).

• Das Plex-Token wird über eine Umgebungsvariable übergeben – binden Sie es niemals fest in das Image ein.

• Ein .githooks/pre-commit führt bei jedem Commit gitleaks aus. Aktivieren Sie es einmal pro Klon: git config core.hooksPath .githooks