Repolode
제출하기
drolosoft

drolosoft/immich-photo-manager

AI 어시스턴트가 셀프 호스팅 Immich 라이브러리에서 사진을 검색하고 정리하며, 중복을 찾고 선별할 수 있도록 하는 MCP 서버 및 Claude Code 플러그인입니다.

대체할 수 있는 제품:Google Photos

GitHub에서 보기웹사이트
스타
62
포크
11
열린 이슈
1
마지막 커밋
그저께

어떤 프로젝트인가요?

immich-photo-manager는 Immich의 공개 API를 통해 AI 어시스턴트를 셀프 호스팅 Immich 사진 서버에 연결하는 MCP 서버이자 Claude Code 플러그인입니다. CLIP과 OCR을 활용한 자연어 검색, 앨범 생성(GPS, 시각 검색, 날짜를 바탕으로 한 위치 앨범 포함), 중복 탐지, 인물 및 얼굴 관리, 타임스탬프와 시간대 수정 같은 메타데이터 복구, 휴지통 처리 등 94개의 도구를 제공합니다.

서버는 사용자 컴퓨터에서 로컬로 실행되며, 설정한 Immich 인스턴스에만 연결합니다. 썸네일을 반환하는 읽기 작업에서는 해당 이미지가 사용하는 모델로 전송되므로, 클라우드 어시스턴트를 사용하면 썸네일이 네트워크 외부로 전송됩니다. MCP를 통해 로컬 모델을 사용하면 모든 데이터가 내부에 머뭅니다. 삭제와 같은 파괴적인 작업은 먼저 결과를 보여 주고 확인을 기다립니다.

Claude Code 플러그인 외에도 stdio 또는 Streamable HTTP를 사용하는 모든 MCP 호환 클라이언트에서 서버를 사용할 수 있으며, Docker 이미지로도 제공됩니다. 또한 비디오 프레임이 포함된 PDF 사진첩과 독립형 HTML 갤러리를 내보낼 수 있습니다. 제작자는 Immich 2.7.5 및 3.1.0에서 실제 환경 테스트를 마쳤다고 밝혔습니다.

핵심 기능

  • 01CLIP 및 이미지 내 OCR 텍스트를 활용한 자연어 사진 검색
  • 02GPS, 시각 검색, 날짜를 조합한 위치별 및 테마별 앨범 생성
  • 03가져온 라이브러리 전반에서 지각 해시를 활용한 중복 탐지
  • 04타임스탬프, 시간대, 누락된 GPS 메타데이터 복구
  • 05얼굴 병합 및 재할당을 포함한 인물 및 얼굴 관리
  • 06PDF 사진첩 및 인터랙티브 HTML 갤러리 내보내기

활용 사례

  • AI 어시스턴트를 통해 대규모 셀프 호스팅 Immich 라이브러리 정리
  • 한 번의 요청으로 GPS와 날짜를 바탕으로 여행 또는 위치 앨범 만들기
  • 여러 서비스에서 사진을 가져온 뒤 중복되거나 품질이 낮은 사진을 찾아 정리
  • LM Studio를 통해 Gemma 같은 모델로 Immich에 연결하는 완전 로컬 어시스턴트 실행

빠른 시작

  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를 사용하면 썸네일이 네트워크 외부로 전송됩니다.

포함된 컬렉션

Claude Code용 MCP 서버셀프호스팅 사진 라이브러리Claude Code 도구·스킬·플러그인MCP 서버셀프 호스팅 앱

토픽

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

자주 묻는 질문

immich-photo-manager은(는) 무엇인가요?
AI 어시스턴트가 셀프 호스팅 Immich 라이브러리에서 사진을 검색하고 정리하며, 중복을 찾고 선별할 수 있도록 하는 MCP 서버 및 Claude Code 플러그인입니다. immich-photo-manager는 Immich의 공개 API를 통해 AI 어시스턴트를 셀프 호스팅 Immich 사진 서버에 연결하는 MCP 서버이자 Claude Code 플러그인입니다. CLIP과 OCR을 활용한 자연어 검색, 앨범 생성(GPS, 시각 검색, 날짜를 바탕으로 한 위치 앨범 포함), 중복 탐지, 인물 및 얼굴 관리, 타임스탬프와 시간대 수정 같은 메타데이터 복구, 휴지통 처리 등 94개의 도구를 제공합니다.
immich-photo-manager은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
immich-photo-manager은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
immich-photo-manager은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. immich-photo-manager의 마지막 커밋은 2026년 11월 5일입니다.
immich-photo-manager은(는) 어디에 사용할 수 있나요?
AI 어시스턴트를 통해 대규모 셀프 호스팅 Immich 라이브러리 정리 한 번의 요청으로 GPS와 날짜를 바탕으로 여행 또는 위치 앨범 만들기 여러 서비스에서 사진을 가져온 뒤 중복되거나 품질이 낮은 사진을 찾아 정리 LM Studio를 통해 Gemma 같은 모델로 Immich에 연결하는 완전 로컬 어시스턴트 실행
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를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트