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.

其他分类下的更多 MCP 服务器

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

ICSS

chokcoco

不止于 CSS

20.7K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.