Plex MCP Server

Servidor MCP Plex

Pesquise e gerencie suas bibliotecas de mídia do Plex com o Claude. Desenvolvido ativamente por Claude e um humano nerd que usa o Plex principalmente para prazeres auditivos e queria ver o quanto poderia ser realizado sem saber muito sobre o que está fazendo. Os resultados podem variar, mas provavelmente de forma positiva.

Início Rápido

Instalação via Smithery (Recomendado)

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

Configuração Manual para o Claude Desktop

Adicione às configurações MCP do seu Claude Desktop:

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

Autenticação

Opção 1: OAuth (Recomendado)

• Use a ferramenta authenticate_plex para obter uma URL de login
• Entre pelo seu navegador

Opção 2: Token Estático

• Adicione "PLEX_TOKEN": "your_token" à seção de ambiente (env)
• Obtenha seu token em Suporte do Plex

Nota: Substitua your-plex-server:32400 pelo endereço e porta reais do seu servidor Plex.

Registro de Depuração HTTP

Para solucionar problemas de conexão, você pode ativar o registro abrangente de requisições/respostas HTTP:

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

Quando MCP_HTTP_DEBUG=true, o servidor registrará:

• Detalhes da Requisição: Método, URL, cabeçalhos, parâmetros, tempo
• Detalhes da Resposta: Códigos de status, cabeçalhos, tamanho da resposta, duração
• Diagnóstico de Erros: Detalhes da conexão, informações de certificado TLS/SSL, sugestões de solução de problemas
• Métricas de Desempenho: Consulta DNS, conexão TCP, tempo do handshake TLS
• Segurança: Todos os cabeçalhos sensíveis (tokens, autenticação) são automaticamente ocultados

Todos os registros são JSON estruturado com IDs de correlação para rastreamento de requisições/respostas.

O Que Você Pode Fazer

Pesquisa e Navegação

• Pesquise filmes, programas de TV, músicas e outros conteúdos
• Navegue por bibliotecas e coleções
• Veja conteúdos adicionados recentemente e histórico de exibição

Descoberta de Música

• Descoberta de música em linguagem natural ("músicas dos anos 90", "bandas de rock que não conheço")
• Recomendações inteligentes baseadas em padrões de audição
• Randomização inteligente para variedade e surpresa
• Descoberta de artistas semelhantes e exploração de gêneros

Playlists

• Crie e gerencie playlists
• Adicione itens a playlists existentes
• Navegue pelo conteúdo das playlists

Informações de Mídia

• Obtenha informações detalhadas de mídia (codecs, taxas de bits, tamanhos de arquivo)
• Verifique status de exibição e progresso
• Veja estatísticas da biblioteca e estatísticas de audição

Recursos (Acesso a Dados)

• Acesse dados estruturados via URI: plex://libraries, plex://recent, plex://playlists
• Dados específicos da biblioteca: plex://library/{id}, plex://library/{id}/recent
• Estatísticas do servidor e status da conexão
• Dados formatados em JSON para análise e automação

Prompts (Assistência de IA)

• playlist_description: Gere descrições criativas de playlists
• content_recommendation: Obtenha recomendações personalizadas de conteúdo
• smart_playlist_rules: Crie critérios e regras para playlists inteligentes
• media_analysis: Analise o conteúdo e os padrões da biblioteca
• server_troubleshooting: Diagnostique problemas de conexão do servidor

Status

✅ Funcionando: Pesquisa, navegação, playlists, informações de mídia, estatísticas da biblioteca, histórico de exibição, coleções, descoberta de música, recursos, prompts

❌ Desativado: Playlists inteligentes (lógica de filtro quebrada)

🚧 Planejado: Navegação em servidores remotos

Desenvolvimento

Quer contribuir? Aponte o Claude para sua versão local:

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

Funciona para nós. Se não funcionar para você, bem, tentamos. Fale com a gente, não mordemos. Quase.