Immich Photo Manager MCP Server

@drolosoft

リポジトリホームページ

基本情報

カテゴリ

その他

ライセンス

MIT

トランスポート

stdio

作者

drolosoft

投稿者

Juan Andrés Moreno Rubio

Immich Photo Manager MCP Server について

📸🧹🗺️ MCP server for intelligent photo management with Immich — search, curate geographic albums, clean up libraries, and publish galleries

#immich#photos#gallery#self-hosted #claude-code #plugin #search#albums#duplicates

Immich Photo Manager MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "immich": {
      "command": "python3",
      "args": [
        "-m",
        "immich_mcp_server"
      ],
      "env": {
        "PYTHONPATH": "${CLAUDE_PLUGIN_ROOT}/src",
        "MCP_TRANSPORT": "stdio",
        "IMMICH_BASE_URL": "https://your-immich-server.com",
        "IMMICH_API_KEY": "YOUR-API-KEY-HERE"
      }
    }
  }
}

Immich Photo Manager MCP Server のツール

ツール一覧はまだありません

この掲載には表示できるツール一覧がまだありません。サーバーにツールがないという意味ではありません。対応機能はプロジェクトのドキュメントをご確認ください。

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is Immich Photo Manager?

Immich Photo Manager is an MCP (Model Context Protocol) server that gives any AI assistant direct access to a self-hosted Immich instance for intelligent photo management. Designed for users whose Immich library has grown beyond manual management, it enables natural‑language search, organization, deduplication, and album curation without scripts or manual sorting.

How to use Immich Photo Manager?

Install as a Claude plugin (claude plugin add immich-photo-manager) or configure any MCP‑compatible client with the package entry point via uvx. Set environment variables IMMICH_BASE_URL and IMMICH_API_KEY. The server defaults to stdio transport; set MCP_TRANSPORT=http for Streamable HTTP.

Key features of Immich Photo Manager

AI‑powered natural language search via CLIP
Geographic albums combining GPS, CLIP, and temporal matching
Metadata repair: timestamps, GPS inference, timezone correction
Duplicate detection using perceptual hashing across imports
Bulk rotation (90°/180°/270°) — non‑destructive and revertible
People and face management: list, merge, reassign, view thumbnails
Library health report: inventory, metadata quality, storage analysis
Tags: create, apply, and bulk manage across assets
Interactive HTML galleries with three themes and batch actions

Use cases of Immich Photo Manager

Ask “find my sunset photos from Italy” — natural language photo search
Say “create albums for all my trips” — auto‑curated geographic albums
Fix misdated photos (noon/midnight) or infer missing GPS coordinates
Detect re‑encoded duplicates from Apple Photos, Google Photos, or other imports
Rotate an entire album at once; check library health with one command

よくある質問

How does Immich Photo Manager differ from manual scripts or the Immich UI?

It replaces manual API calls, JSON parsing, and per‑file EXIF editing with natural‑language commands. For example, “find my sunset photos from Italy” replaces writing search queries, and “repair timestamps” batch‑fixes metadata where the UI would require one‑by‑one editing.

What are the runtime requirements?

A running Immich instance (self‑hosted, v1.90+), an Immich API key, Python 3.10+ with pip. The server runs locally; your photos never leave your server.

Where does my photo data live, and what transport protocols are supported?

All operations occur against your self‑hosted Immich instance. The server uses MCP stdio transport by default; set `MCP_TRANSPORT=http` for Streamable HTTP. No external cloud dependency.

Which AI clients have been tested or are compatible?

Tested with Claude Desktop, Claude Code, and LM Studio (Gemma 4). Compatible with any MCP client (Cursor, Windsurf, VS Code, Cline, Zed, etc.).

How does the server handle safety and destructive actions?

It shows findings and asks before acting — e.g., when deleting, rotating, or merging assets. Galleries include a Cowork Actions Panel for batch operations where users paste the CLI command after reviewing the selection.

「その他」の他のコンテンツ

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep