Repolode
drolosoft

drolosoft/immich-photo-manager

MCP-сервер и плагин для Claude Code, с помощью которых AI-ассистенты ищут, сортируют, удаляют дубликаты и отбирают фото в собственной библиотеке Immich.

Open source альтернатива:Google Photos

Звёзды
62
Форки
11
Открытые issues
1
Последний коммит
позавчера

Что это?

immich-photo-manager — это MCP-сервер и плагин для Claude Code, которые подключают AI-ассистента к собственному фотосерверу Immich через публичный API Immich. Он предоставляет 94 инструмента: поиск на естественном языке с помощью CLIP и OCR, создание альбомов (в том числе географических — по GPS, визуальному поиску и датам), поиск дубликатов, управление людьми и лицами, исправление метаданных, например времени и часового пояса, а также работу с корзиной.

Сервер работает локально на вашем компьютере и подключается только к настроенному вами экземпляру Immich. При операциях чтения, которые возвращают миниатюры, эти изображения отправляются используемой вами модели. Поэтому при работе с облачным ассистентом миниатюры покидают вашу сеть, а локальная модель через MCP позволяет хранить всё внутри неё. Перед удалением сервер показывает результаты и запрашивает подтверждение.

Помимо плагина для Claude Code, сервер совместим с любым MCP-клиентом и работает через stdio или Streamable HTTP; также доступен образ Docker. Он умеет экспортировать фотокниги в PDF с кадрами из видео и автономные HTML-галереи. Автор указывает, что проект проверен на работающих экземплярах Immich 2.7.5 и 3.1.0.

Ключевые возможности

  • 01Поиск фотографий на естественном языке с помощью CLIP и OCR-текста на изображениях
  • 02Создание географических и тематических альбомов на основе GPS, визуального поиска и дат
  • 03Поиск дубликатов с помощью перцептивного хеширования в импортированных библиотеках
  • 04Исправление метаданных: времени, часовых поясов и отсутствующих GPS-данных
  • 05Управление людьми и лицами, в том числе объединение и переназначение лиц
  • 06Экспорт фотокниг в PDF и интерактивных HTML-галерей

Сценарии использования

  • Организация большой собственной библиотеки Immich с помощью AI-ассистента
  • Создание альбомов поездок или местоположений по GPS и датам одним запросом
  • Поиск и удаление дубликатов или фотографий низкого качества после импорта из нескольких сервисов
  • Запуск полностью локального ассистента для работы с Immich и моделью вроде Gemma через LM Studio

Быстрый старт

  1. 1

    Клонируйте репозиторий

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

    Установите зависимости Python из клонированной папки

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

    Добавьте маркетплейс плагинов из клонированной папки

    claude plugin marketplace add ./
  4. 4

    Установите плагин в Claude Code, затем выполните /setup-immich-photo-manager, чтобы подключить сервер Immich

    claude plugin install immich-photo-manager

Что важно знать

  • Для работы нужен запущенный собственный сервер Immich и API-ключ.
  • Требуется Python версии 3.10 или выше.
  • Миниатюры, которые просматривает ассистент, отправляются используемой вами модели; при использовании Claude они покидают вашу сеть.

В подборках

Темы

Частые вопросы

Что такое immich-photo-manager?
MCP-сервер и плагин для Claude Code, с помощью которых AI-ассистенты ищут, сортируют, удаляют дубликаты и отбирают фото в собственной библиотеке Immich. immich-photo-manager — это MCP-сервер и плагин для Claude Code, которые подключают AI-ассистента к собственному фотосерверу Immich через публичный API Immich. Он предоставляет 94 инструмента: поиск на естественном языке с помощью CLIP и OCR, создание альбомов (в том числе географических — по GPS, визуальному поиску и датам), поиск дубликатов, управление людьми и лицами, исправление метаданных, например времени и часового пояса, а также работу с корзиной.
immich-photo-manager можно использовать бесплатно? Какая у него лицензия?
immich-photo-manager распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
immich-photo-manager всё ещё поддерживается?
Активно поддерживается. Последний коммит в immich-photo-manager — 5 нояб. 2026 г..
Для чего можно использовать immich-photo-manager?
Организация большой собственной библиотеки Immich с помощью AI-ассистента Создание альбомов поездок или местоположений по GPS и датам одним запросом Поиск и удаление дубликатов или фотографий низкого качества после импорта из нескольких сервисов Запуск полностью локального ассистента для работы с Immich и моделью вроде Gemma через LM Studio
Как установить immich-photo-manager?
Клонируйте репозиторий: git clone https://github.com/drolosoft/immich-photo-manager.git Установите зависимости Python из клонированной папки: pip3 install -r src/requirements.txt Добавьте маркетплейс плагинов из клонированной папки: claude plugin marketplace add ./ Установите плагин в Claude Code, затем выполните /setup-immich-photo-manager, чтобы подключить сервер Immich: claude plugin install immich-photo-manager
Где скачать immich-photo-manager?
Исходный код и инструкции по установке — на GitHub: https://github.com/drolosoft/immich-photo-manager

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Самостоятельно размещаемая фотогалерея: извлекает EXIF, определяет места съёмки, воспроизводит Live Photos и предлагает альбомы и просмотр на карте.

2 тыс.+7 за неделю156VueMITАктивно поддерживаетсяОбновлён 12 часов назад

Приложение для самостоятельного управления фото и видео с резервным копированием с телефона, распознаванием лиц и поиском — альтернатива Google Photos.

118,4 тыс.+673 за неделю7,5 тыс.TypeScriptAGPL-3.0Активно поддерживаетсяОбновлён 13 часов назад

Самостоятельно размещаемое приложение для фото с приоритетом конфиденциальности: автоматически добавляет метки, распознаёт лица и отображает на карте фотографии и видео.

40,4 тыс.+37 за неделю2,3 тыс.GoOtherАктивно поддерживаетсяОбновлён позавчера