Repolode
Enviar
drolosoft

drolosoft/immich-photo-manager

Servidor MCP e plugin do Claude Code que permite a assistentes de IA pesquisar, organizar, deduplicar e selecionar fotos em uma biblioteca Immich auto-hospedada.

Alternativa open source a:Google Photos

Ver no GitHubSite
Estrelas
62
Forks
11
Issues abertas
1
Último commit
ontem

O que é?

immich-photo-manager é um servidor MCP e plugin do Claude Code que conecta um assistente de IA a um servidor de fotos Immich auto-hospedado pela API pública do Immich. Ele disponibiliza 94 ferramentas, incluindo busca em linguagem natural com CLIP e OCR, criação de álbuns (inclusive álbuns geográficos criados com GPS, busca visual e datas), detecção de duplicatas, gerenciamento de pessoas e rostos, correção de metadados, como ajustes de data e fuso horário, e gerenciamento da lixeira.

O servidor é executado localmente na sua máquina e se comunica apenas com a instância do Immich que você configurar. Nas operações de leitura que retornam miniaturas, essas imagens são enviadas ao modelo utilizado; portanto, com um assistente na nuvem, as miniaturas saem da sua rede. Com um modelo local via MCP, tudo permanece dentro dela. Ações destrutivas, como exclusões, exibem os resultados encontrados e aguardam confirmação.

Além do plugin para Claude Code, o servidor funciona com qualquer cliente compatível com MCP, via stdio ou Streamable HTTP, e também está disponível como imagem Docker. Ele também exporta fotolivros em PDF com quadros de vídeo e galerias HTML autocontidas. O autor afirma que o projeto foi testado ao vivo com Immich 2.7.5 e 3.1.0.

Recursos principais

  • 01Busca de fotos em linguagem natural usando CLIP e texto detectado por OCR nas imagens
  • 02Criação de álbuns geográficos e temáticos combinando GPS, busca visual e datas
  • 03Detecção de duplicatas com hashing perceptual em bibliotecas importadas
  • 04Correção de metadados de datas, fusos horários e dados de GPS ausentes
  • 05Gerenciamento de pessoas e rostos, incluindo mesclar e reatribuir rostos
  • 06Exportação de fotolivros em PDF e galerias HTML interativas

Casos de uso

  • Organizar uma grande biblioteca Immich auto-hospedada usando um assistente de IA
  • Criar álbuns de viagens ou locais com GPS e datas em uma única solicitação
  • Encontrar e remover fotos duplicadas ou de baixa qualidade após importar conteúdo de vários serviços
  • Executar um assistente totalmente local conectado ao Immich, usando um modelo como Gemma via LM Studio

Início rápido

  1. 1

    Clone o repositório

    git clone https://github.com/drolosoft/immich-photo-manager.git
  2. 2

    Instale as dependências do Python na pasta clonada

    pip3 install -r src/requirements.txt
  3. 3

    Adicione o marketplace de plugins a partir da pasta clonada

    claude plugin marketplace add ./
  4. 4

    Instale o plugin no Claude Code e, em seguida, execute /setup-immich-photo-manager para conectar seu servidor Immich

    claude plugin install immich-photo-manager

Antes de usar

  • Para funcionar, você precisa de um servidor Immich auto-hospedado em execução e de uma chave de API.
  • Requer Python 3.10 ou posterior.
  • As miniaturas que o assistente visualiza são enviadas ao modelo que você usa; com o Claude, elas saem da sua rede.

Em coleções

Servidores MCP para Claude CodeBibliotecas de fotos auto-hospedadasFerramentas, skills e plugins para Claude CodeServidores MCPApps auto-hospedados

Tópicos

#immich#mcp#photo-management#self-hosted#claude#geolocation#deduplication#ai-assistant#albums#claude-plugin

Perguntas frequentes

O que é immich-photo-manager?
Servidor MCP e plugin do Claude Code que permite a assistentes de IA pesquisar, organizar, deduplicar e selecionar fotos em uma biblioteca Immich auto-hospedada. immich-photo-manager é um servidor MCP e plugin do Claude Code que conecta um assistente de IA a um servidor de fotos Immich auto-hospedado pela API pública do Immich. Ele disponibiliza 94 ferramentas, incluindo busca em linguagem natural com CLIP e OCR, criação de álbuns (inclusive álbuns geográficos criados com GPS, busca visual e datas), detecção de duplicatas, gerenciamento de pessoas e rostos, correção de metadados, como ajustes de data e fuso horário, e gerenciamento da lixeira.
immich-photo-manager é gratuito? Qual é a licença?
immich-photo-manager é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
immich-photo-manager ainda é mantido?
Manutenção ativa. O último commit de immich-photo-manager foi em 5 de nov. de 2026.
Para que posso usar immich-photo-manager?
Organizar uma grande biblioteca Immich auto-hospedada usando um assistente de IA Criar álbuns de viagens ou locais com GPS e datas em uma única solicitação Encontrar e remover fotos duplicadas ou de baixa qualidade após importar conteúdo de vários serviços Executar um assistente totalmente local conectado ao Immich, usando um modelo como Gemma via LM Studio
Como instalar immich-photo-manager?
Clone o repositório: git clone https://github.com/drolosoft/immich-photo-manager.git Instale as dependências do Python na pasta clonada: pip3 install -r src/requirements.txt Adicione o marketplace de plugins a partir da pasta clonada: claude plugin marketplace add ./ Instale o plugin no Claude Code e, em seguida, execute /setup-immich-photo-manager para conectar seu servidor Immich: claude plugin install immich-photo-manager
Onde consigo immich-photo-manager?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/drolosoft/immich-photo-manager

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados