Repolode
Enviar
drolosoft

drolosoft/immich-photo-manager

Servidor MCP y plugin de Claude Code que permite a asistentes de IA buscar, organizar, deduplicar y seleccionar fotos de una biblioteca de Immich autoalojada.

Alternativa open source a:Google Photos

Ver en GitHubSitio web
Estrellas
62
Forks
11
Issues abiertos
1
Último commit
anteayer

¿Qué es?

immich-photo-manager es un servidor MCP y un plugin de Claude Code que conecta un asistente de IA con un servidor de fotos Immich autoalojado mediante la API pública de Immich. Ofrece 94 herramientas que abarcan búsquedas en lenguaje natural con CLIP y OCR, creación de álbumes (incluidos álbumes geográficos basados en GPS, búsqueda visual y fechas), detección de duplicados, gestión de personas y rostros, reparación de metadatos —como la corrección de marcas de tiempo y zonas horarias— y gestión de la papelera.

El servidor se ejecuta localmente en tu equipo y solo se comunica con la instancia de Immich que configures. Las operaciones de lectura que devuelven miniaturas envían esas imágenes al modelo que uses, así que, si utilizas un asistente en la nube, las miniaturas salen de tu red; con un modelo local a través de MCP, todo permanece dentro de ella. Las acciones destructivas, como eliminar archivos, muestran primero los resultados y esperan una confirmación.

Además del plugin de Claude Code, el servidor funciona con cualquier cliente compatible con MCP mediante stdio o Streamable HTTP, y se distribuye como imagen de Docker. También exporta fotolibros en PDF con fotogramas de video y galerías HTML autocontenidas. El autor indica que el proyecto se prueba en vivo con Immich 2.7.5 y 3.1.0.

Funciones clave

  • 01Búsqueda de fotos en lenguaje natural con CLIP y OCR del texto dentro de las imágenes
  • 02Creación de álbumes geográficos y temáticos que combinan GPS, búsqueda visual y fechas
  • 03Detección de duplicados mediante hash perceptual en bibliotecas importadas
  • 04Reparación de metadatos: marcas de tiempo, zonas horarias y datos GPS faltantes
  • 05Gestión de personas y rostros, incluida la combinación y reasignación de rostros
  • 06Exportación de fotolibros en PDF y galerías HTML interactivas

Casos de uso

  • Organizar una gran biblioteca de Immich autoalojada mediante un asistente de IA
  • Crear álbumes de viajes o por ubicación a partir del GPS y las fechas en una sola solicitud
  • Encontrar y eliminar fotos duplicadas o de baja calidad después de importar contenido de varios servicios
  • Usar un asistente totalmente local con Immich y un modelo como Gemma a través de LM Studio

Inicio rápido

  1. 1

    Clona el repositorio

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

    Instala las dependencias de Python desde la carpeta clonada

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

    Añade el marketplace de plugins desde la carpeta clonada

    claude plugin marketplace add ./
  4. 4

    Instala el plugin en Claude Code y, después, ejecuta /setup-immich-photo-manager para conectar tu servidor Immich

    claude plugin install immich-photo-manager

Antes de usarlo

  • Necesitas un servidor Immich autoalojado en funcionamiento y una clave de API para que pueda hacer algo.
  • Requiere Python 3.10 o posterior.
  • Las miniaturas que ve el asistente se envían al modelo que uses; si usas Claude, salen de tu red.

En colecciones

Servidores MCP para Claude CodeBibliotecas de fotos autoalojadasHerramientas, skills y plugins para Claude CodeServidores MCPApps autoalojadas

Temas

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

Preguntas frecuentes

¿Qué es immich-photo-manager?
Servidor MCP y plugin de Claude Code que permite a asistentes de IA buscar, organizar, deduplicar y seleccionar fotos de una biblioteca de Immich autoalojada. immich-photo-manager es un servidor MCP y un plugin de Claude Code que conecta un asistente de IA con un servidor de fotos Immich autoalojado mediante la API pública de Immich. Ofrece 94 herramientas que abarcan búsquedas en lenguaje natural con CLIP y OCR, creación de álbumes (incluidos álbumes geográficos basados en GPS, búsqueda visual y fechas), detección de duplicados, gestión de personas y rostros, reparación de metadatos —como la corrección de marcas de tiempo y zonas horarias— y gestión de la papelera.
¿immich-photo-manager es gratuito? ¿Qué licencia tiene?
immich-photo-manager es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿immich-photo-manager sigue mantenido?
Mantenimiento activo. El último commit de immich-photo-manager fue el 5 nov 2026.
¿Para qué puedo usar immich-photo-manager?
Organizar una gran biblioteca de Immich autoalojada mediante un asistente de IA Crear álbumes de viajes o por ubicación a partir del GPS y las fechas en una sola solicitud Encontrar y eliminar fotos duplicadas o de baja calidad después de importar contenido de varios servicios Usar un asistente totalmente local con Immich y un modelo como Gemma a través de LM Studio
¿Cómo se instala immich-photo-manager?
Clona el repositorio: git clone https://github.com/drolosoft/immich-photo-manager.git Instala las dependencias de Python desde la carpeta clonada: pip3 install -r src/requirements.txt Añade el marketplace de plugins desde la carpeta clonada: claude plugin marketplace add ./ Instala el plugin en Claude Code y, después, ejecuta /setup-immich-photo-manager para conectar tu servidor Immich: claude plugin install immich-photo-manager
¿Dónde consigo immich-photo-manager?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/drolosoft/immich-photo-manager

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados