Plex MCP Server

Servidor Plex MCP

Busca y gestiona tus bibliotecas multimedia de Plex con Claude. Desarrollado activamente por Claude y un humano friki que usa Plex principalmente para delicias auditivas y quería ver cuánto se podía lograr sin saber mucho de lo que están haciendo. Los resultados pueden variar, pero probablemente para bien.

Inicio rápido

Instalar vía Smithery (Recomendado)

npx -y @smithery/cli install @vyb1ng/plex-mcp --client claude

Configuración manual para Claude Desktop

Añade a la configuración MCP de tu Claude Desktop:

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

Autenticación

Opción 1: OAuth (Recomendado)

• Usa la herramienta authenticate_plex para obtener una URL de inicio de sesión
• Inicia sesión a través de tu navegador

Opción 2: Token estático

• Añade "PLEX_TOKEN": "your_token" a la sección de variables de entorno
• Obtén tu token desde Soporte de Plex

Nota: Reemplaza your-plex-server:32400 con la dirección y el puerto reales de tu servidor Plex.

Registro de depuración HTTP

Para solucionar problemas de conexión, puedes habilitar un registro exhaustivo de solicitudes/respuestas HTTP:

{
  "mcpServers": {
    "plex": {
      "command": "npx",
      "args": ["plex-mcp"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400",
        "MCP_HTTP_DEBUG": "true"
      }
    }
  }
}

Cuando MCP_HTTP_DEBUG=true, el servidor registrará:

• Detalles de solicitud: método, URL, cabeceras, parámetros, tiempos
• Detalles de respuesta: códigos de estado, cabeceras, tamaño de respuesta, duración
• Diagnóstico de errores: detalles de conexión, información de certificados TLS/SSL, sugerencias de solución
• Métricas de rendimiento: resolución DNS, conexión TCP, tiempo de negociación TLS
• Seguridad: todas las cabeceras sensibles (tokens, autenticación) se redactan automáticamente

Todos los registros son JSON estructurado con IDs de correlación para el seguimiento de solicitudes y respuestas.

Lo que puedes hacer

Búsqueda y navegación

• Buscar películas, series, música y otro contenido
• Explorar bibliotecas y colecciones
• Ver contenido añadido recientemente e historial de visualización

Descubrimiento de música

• Descubrimiento musical en lenguaje natural ("canciones de los 90", "bandas de rock que no he escuchado")
• Recomendaciones inteligentes basadas en patrones de escucha
• Aleatorización inteligente para variedad y sorpresa
• Descubrimiento de artistas similares y exploración de géneros

Listas de reproducción

• Crear y gestionar listas de reproducción
• Añadir elementos a listas existentes
• Explorar el contenido de las listas

Información de medios

• Obtener información detallada de los medios (códecs, tasas de bits, tamaños de archivo)
• Consultar el estado de visualización y el progreso
• Ver estadísticas de biblioteca y estadísticas de escucha

Recursos (acceso a datos)

• Acceder a datos estructurados mediante URI: plex://libraries, plex://recent, plex://playlists
• Datos específicos de biblioteca: plex://library/{id}, plex://library/{id}/recent
• Estadísticas del servidor y estado de conexión
• Datos en formato JSON para análisis y automatización

Prompts (asistencia de IA)

• playlist_description: generar descripciones creativas de listas de reproducción
• content_recommendation: obtener recomendaciones de contenido personalizadas
• smart_playlist_rules: crear criterios y reglas para listas inteligentes
• media_analysis: analizar el contenido y los patrones de la biblioteca
• server_troubleshooting: diagnosticar problemas de conexión del servidor

Estado

✅ Funcionando: búsqueda, navegación, listas de reproducción, información de medios, estadísticas de biblioteca, historial de visualización, colecciones, descubrimiento de música, recursos, prompts

❌ Deshabilitado: listas inteligentes (lógica de filtros rota)

🚧 Planificado: navegación remota del servidor

Desarrollo

¿Quieres contribuir? Dirige Claude a tu versión local:

{
  "mcpServers": {
    "plex-dev": {
      "command": "node",
      "args": ["/path/to/plex-mcp/index.js"],
      "env": {
        "PLEX_URL": "http://your-plex-server:32400"
      }
    }
  }
}

A nosotros nos funciona. Si a ti no te funciona, bueno, lo intentamos. Escríbenos, no mordemos. Mucho.