用途:当本地 Immich 照片库规模过大、难以手工整理时,该插件让 Claude 直接访问你的 Immich 实例,用对话方式完成检索、整理与修复。提供 94 个 MCP 工具和 13 项技能,全部在本机运行,只与自己的 Immich 通信,原图不离开服务器。
主要能力:支持 CLIP 视觉自然语言搜索(如“sunset at the beach”),并可按人物、地点、日期、相机筛选;OCR 可按照片中的文字查找票据、标牌或文档;依据 GPS 聚类与时间匹配生成地理相册;通过感知哈希做跨来源重复检测,可识别 Apple Photos 和 Google Takeout 的转码副本,近似重复项可堆叠而非删除;可列举、搜索、合并、重命名人物并重新分配误识别人脸;修复正午/午夜时间戳、由邻近照片推断缺失 GPS、修正时区偏移;从视频等距抽帧,把相册或选择导出为带说明的本地 PDF 相册;一次调用获得按月分桶、显示缺口的日历热力图及“往年今日”回忆;输出资产清单、元数据质量、存储分布与建议;把审查结论存在资产上供下次清理跳过;生成含内嵌缩略图、3 种主题、4 种视图和幻灯片的自包含 HTML 画廊。安全方面:所有写入前先展示并确认,默认进入回收站,永久删除仅在明确要求时执行。
使用方式:克隆仓库后安装依赖并作为插件加载—— 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 key”。也可用 uvx immich-photo-manager 供其他 MCP 客户端使用,或使用 Docker 镜像 ghcr.io/drolosoft/immich-photo-manager(HTTP 方式 MCP,端口 8626)。涉及技能包括 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。
适用场景:旅行照片归类、按内容或票据文字找图、跨来源查重、人脸与人物整理、时间与 GPS 元数据修复、存储占用分析、相册导出与浏览。
限制:需要 Immich 1.90+、API key 与 Python 3.10+;兼容 Claude Code、Claude Desktop、LM Studio 及任意 MCP 客户端。具体价格、授权以外的收费信息资料未提供。