关于 immich-photo-manager
Immich 照片管理工具，提供 MCP 服务和 Claude Code 插件，适用于管理自托管 Immich 图库。它结合自然语言与 OCR 搜索、重复项检测和元数据修复，并在写入前展示结果供确认。
主要功能
- 01按描述、人物、地点和日期搜索
- 02通过 OCR 搜索照片文字
- 03按地理位置创建相册
- 04跨来源检测重复照片
- 05管理人物、面孔和元数据
- 06生成 PDF 相册与交互式图库
适用场景
- 01查找特定地点或包含文字的照片
- 02整理旅行地点相册
- 03检查不同来源的重复照片
- 04修复时间戳或缺失 GPS 信息
MCP 相关
提供 94 个 MCP 工具，供 MCP 客户端访问 Immich 图库的搜索、整理和管理功能。可通过 `uvx immich-photo-manager` 或 Docker 镜像运行 MCP 服务。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/immich-photo-manager确认已加载。
详细介绍
Immich 照片管理器
面向可自托管的 Immich 的 MCP 服务和 Claude Code 插件，助力智能照片管理。
概览
当你的 Immich 照片库大到难以手动管理时，这款插件可让 Claude 通过 94 个 MCP 工具和 13 个技能直接访问你的实例。你可以用自然语言或照片中的文字进行搜索，根据 GPS 数据创建地理相册，查找不同导入来源中的重复照片，管理人物和人脸，修复元数据，从视频中截取画面，将相册导出为 PDF 照片书，并在交互式 HTML 画廊中浏览结果。插件在你的机器上运行，只与自己的 Immich 通信；原始照片绝不会离开你的服务器。
主要功能
- 自然语言搜索：使用 CLIP 进行视觉搜索（“海滩上的日落”“生日蛋糕”），还可按人物、地点、日期和相机筛选
- 搜索照片中的文字：通过 OCR 搜索，按票据、标牌或文档上的文字查找照片
- 地理相册：根据 GPS 聚类和时间匹配，按地点整理相册
- 重复照片检测：跨来源分析并使用感知哈希（可检测来自 Apple Photos 和 Google Takeout 的重新编码副本）；近似重复照片可以堆叠，而不是删除
- 人物和人脸：列出、搜索、合并和重命名人物，重新分配识别错误的人脸
- 元数据修复：修正正午和午夜时间戳，根据相邻照片推断缺失的 GPS 数据，校正时区偏移
- 视频画面和 PDF 报告：从任意视频中均匀截取画面，并将相册或所选照片导出为带说明文字的 PDF 照片书，全程在本地生成
- 一次调用查看日期信息：按月汇总、显示日期空缺的日历热力图，以及 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。