mcpField
I
immich-photo-manager

immich-photo-manager

github.com/davepoonクリエイティブ・メディア3.7k97 回インストール今日更新
リポジトリ

immich-photo-manager について

自前運用の Immich ライブラリを管理する MCP サーバー兼 Claude Code プラグインです。自然文検索や OCR、重複検出、メタデータ修復を備え、変更を書き込む前に確認を求めます。

主な機能

  1. 01説明・人物・場所・日付で検索
  2. 02OCR による写真内テキスト検索
  3. 03地理情報を使ったアルバム作成
  4. 04取り込み元をまたいだ重複検出
  5. 05人物・顔・メタデータの管理
  6. 06PDF フォトブックとインタラクティブギャラリーの作成

活用シーン

  1. 01場所や写真内の文字から写真を検索
  2. 02旅行先ごとにアルバムを整理
  3. 03異なる取り込み元の重複写真を確認
  4. 04タイムスタンプや GPS 情報の欠落を修復

MCP 対応

94 個の MCP ツールを公開し、MCP クライアントから Immich ライブラリの検索、整理、管理を行えます。`uvx immich-photo-manager` または Docker イメージで MCP サーバーを起動できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davepoon/buildwithclaude --skill immich-photo-manager

インストール後、Claude Code で/immich-photo-managerを入力して読み込まれたか確認します。

詳細

Immich 写真マネージャー

セルフホスト可能な Immich 向けの、インテリジェントな写真管理用 MCP サーバーおよび Claude Code プラグインです。

概要

Immich ライブラリが手作業で管理できる範囲を超えて増えても、このプラグインを使えば、94 個の MCP ツールと 13 個のスキルを通じて Claude がインスタンスに直接アクセスできます。自然言語や写真内のテキストで検索したり、GPS データから地理的なアルバムを作成したり、インポート元をまたいで重複を検出したり、人物や顔を管理したり、メタデータを修復したり、動画からフレームを切り出したり、アルバムを PDF フォトブックとしてエクスポートしたり、インタラクティブな HTML ギャラリーで結果を閲覧したりできます。プラグインはお使いのマシン上で動作し、Immich とのみ通信します。オリジナルの写真がサーバーの外に出ることはありません。

主な機能

  • 自然言語検索：CLIP によるビジュアル検索（「ビーチの夕日」、「バースデーケーキ」など）に加え、人物、場所、日付、カメラによる絞り込み
  • 写真内のテキスト：OCR 検索で、チケット、看板、文書などに書かれた内容をもとに検索
  • 地理的なアルバム：GPS のクラスタリングと時間的な照合によって場所ごとに整理したアルバム
  • 重複検出：知覚ハッシュを使ってソースをまたいで分析（Apple Photos や Google Takeout から再エンコードされたコピーも検出）。近似重複は削除せず、スタックにまとめることもできます
  • 人物と顔：人物の一覧表示、検索、統合、名前変更、誤認識された顔の割り当て直し
  • メタデータの修復：正午や深夜のタイムスタンプを修正し、近隣の写真から不足している GPS を推測し、タイムゾーンのオフセットを修正
  • 動画のフレームと PDF レポート：任意の動画から等間隔でフレームを抽出し、アルバムや選択した写真を、キャプション付きの PDF フォトブックとしてローカルで作成
  • 1 回の呼び出しで日付を確認：月ごとの分類、空白期間を確認できるカレンダーヒートマップ、Immich の「この日の思い出」
  • ライブラリの健全性：アセットの一覧、メタデータの品質、ストレージの内訳、推奨事項
  • セッション間のメモ：各アセットに判定結果を保存するため、次回の整理では前回確認済みの項目をスキップ
  • インタラクティブなギャラリー：サムネイルを埋め込んだ単独で動作する HTML ファイル。3 種類のテーマ、4 種類の表示モード、スライドショーに対応
  • 安全性を最優先：何かを書き込む前に検出結果を提示し、確認を求めます。まずゴミ箱に移動し、完全削除は依頼された場合のみ実行します

互換性

各リリースはタグ付け前に、Docker 上の実際の Immich 2.7.5 および 3.1.0 に対して実環境テストを実施します（MCP 経由ですべてのツールをテストし、書き込みのたびに状態を再読み込みします）。テストキットはリポジトリ内の tests/live/ にあります。Claude Code、Claude Desktop、LM Studio、および任意の MCP クライアントで動作します。Immich 1.90 以降、API キー、Python 3.10 以降が必要です。

インストール

git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
pip3 install -r src/requirements.txt
claude plugin marketplace add ./
claude plugin install immich-photo-manager

次に、Claude Code 内で /setup-immich-photo-manager を実行するか、「Immich の認証情報を https://photos.example.com と API キー に更新して」と伝えてください。同じサーバーは、他の MCP クライアント向けに uvx immich-photo-manager としても、Docker イメージ（ghcr.io/drolosoft/immich-photo-manager、ポート 8626 で HTTP 経由の MCP）としても利用できます。

使い方

"How healthy is my photo library?"
"Show me my photos from Italy"
"Find the photo with the train ticket"
"Create albums for everywhere I've traveled"
"Find duplicates in my library and keep the best of each group"
"Make me a PDF of the Sintra album"
/cleanup: scan for screenshots and junk
/my-travels: discover all travel destinations

スキル

photo-search、photo-cleanup、duplicate-report、auto-album-curator、album-manager、album-report、travel-map、metadata-fixer、storage-optimizer、library-health-report、people-report、rotate-photos、timeline-gaps。

リンク

コメント

Markdown 対応