immich-photo-manager
用于智能照片管理的MCP服务器 伊米奇 --你的自助图书馆，明白了。
如果你 伊米奇 图书馆已经超出了你手工管理的范围， immich照片管理员 让任何AI助手都可以直接访问您的实例——通过自然对话搜索、组织、消除重复和整理相册。适用于Claude、Gemma或任何兼容MCP的客户端。在本地运行——你的照片永远不会离开你的服务器。
______________________________________________________________________
它做什么
说 “为我的所有旅行创建相册” 看着它工作：
GPS坐标、CLIP视觉搜索和时间匹配——结合在一个请求中，创建了数十个精心策划的相册。没有脚本，没有手动排序。
______________________________________________________________________
快速开始
先决条件
作为Claude插件安装（推荐）
git clone https://github.com/drolosoft/immich-photo-manager.git
cd immich-photo-manager
claude plugin marketplace add .
claude plugin install immich-photo-manager就是这样。问克劳德： “我的照片库有多健康？”
有关手动MCP服务器设置，请参阅 入门指南.
克劳德代码作品
相同的插件在中运行 克劳德代码 --直接从终端搜索您的库、策划相册和生成画廊。
完整对话记录： 克劳德代码演示
适用于任何MCP客户端
immich照片管理员是 MCP服务器 --它可以与任何使用模型上下文协议的人工智能助手配合使用，而不仅仅是Claude。
============================================================
IMMICH-PHOTO-MANAGER × GEMMA 4 (LM STUDIO)
============================================================
Immich: https://your-immich-server.com
Model: gemma4-26b-it (local, LM Studio)
Query: "Show me my Lanzarote albums"
1. Getting MCP tool schemas...
38 MCP tools available
2. Asking Gemma 4...
Gemma 4 chose: list_albums({})
3. Executing 'list_albums' against Immich...
Found 124 total albums, 14 Lanzarote albums:
- Lanzarote Amarillo (26 photos)
- Lanzarote Rojo (201 photos)
- Lanzarote Azul (187 photos)
- Lanzarote Marrón (208 photos)
- Lanzarote Negro (193 photos)
- Lanzarote Verde (201 photos)
- Lanzarote Gasolina (174 photos)
...
4. Gemma 4 interpreting results...
"I found 14 Lanzarote albums — 7 color-themed with
1,190 photos and 7 location-specific albums."
RESULT: Zero cloud dependency — fully self-hosted stack.| 客户端 | 状态 |
|---|---|
| 克劳德代码 | 已测试 |
| 克劳德桌面 | 经过测试 |
| LM工作室（Gemma 4） | 已测试 |
| 光标、风帆、VS代码、Cline、Zed | 兼容（MCP标准） |
完整成绩单： Gemma 4演示 ·测试脚本： test-lmstudio-mcp.py______________________________________________________________________
亮点
- 人工智能驱动的搜索 --通过CLIP进行自然语言照片搜索（“海滩上的日落”、“生日蛋糕”）
- 地理相册 --创建按地点组织的相册，结合GPS+CLIP+时间匹配
- 元数据修复 --修复中午/午夜时间戳，从相邻照片中推断丢失的GPS，纠正时区偏移
- 图书馆清理 --通过多信号分析检测屏幕截图、重复和低质量图像
- 重复检测 --使用感知哈希进行跨源分析（在Apple Photos、Google Photos和其他导入中查找重新编码的副本）
- 批量轮换 --一次旋转整个相册或选择（90°/180°/270°）；非破坏性，跨调用累积，一键还原
- 人员和面部管理 --列出、搜索、合并和组织公认的人；重新分配识别错误的面孔；查看面部缩略图
- 垃圾和资产生命周期 --安全地将资产删除到垃圾箱，永久删除，从垃圾箱恢复；完整的资产生命周期管理
- 图书馆健康 --一个用于资产清单、元数据质量、存储细分和建议的命令
- 互动画廊 --包含嵌入式缩略图、3个主题、4种视图模式和用于批处理操作的协作操作面板的自包含HTML页面
在图库中选择照片，单击操作，然后将命令粘贴到Claude中。看 技能参考 所有11种技能。
______________________________________________________________________
为什么要移民照片管理员？
Immich非常擅长存储和查看您的照片。但是管理一个大型库——重复数据删除、元数据修复、相册管理、存储分析——仍然需要手动操作或自定义脚本。
| 手册/脚本 | immich照片管理器 | |
|---|---|---|
| 🔍 | 编写API调用，解析JSON | 自然语言 --“查找我在意大利拍摄的日落照片” |
| 🗺️ | 导出GPS，手动组合 | 地理相册 --自动GPS+CLIP+时间匹配 |
| 🧹 | 哈希文件、差分校验和 | 感知哈希 --在导入源中查找重新编码的重复项 |
| 🔧 | 一次编辑一个EXIF文件 | 元数据修复 --批量固定时间戳，推断GPS，正确的时区 |
| 📊 | 查询数据库，构建报告 | 图书馆健康 --元数据质量、存储、推荐的一个命令 |
| 🔄 | 一次旋转一张照片 | 批量轮换 --一次旋转整个相册，无损 |
| 🛡️ | 手动审查每个行动 | 安全第一 --展示调查结果，行动前提问 |
______________________________________________________________________
文档
| 文档 | 描述 |
|---|---|
| 入门指南 | 安装、手动MCP设置、部署选项和故障排除 |
| 技能参考 | 全部12项技能——工作流程、触发器、参数、输出格式 |
| MCP工具参考 | 所有38个MCP工具——参数、返回类型、示例 |
| 建筑 | base64嵌入式缩略图如何解决Cowork沙盒限制 |
| CORS设置指南 | 可选--为浏览器查看的库启用直接URL缩略图加载 |
______________________________________________________________________
贡献
欢迎贡献——bug修复、新技能、功能想法。打开问题或提交PR。
如果immich照片管理器帮助管理你的库，可以考虑在GitHub上给它一颗星——它可以帮助其他人发现这个项目。
______________________________________________________________________
支持
如果immich照片管理器为您节省了时间或使您的照片库更易于管理，请考虑给我买一杯咖啡——它会让下一杯咖啡源源不断！
______________________________________________________________________
许可证
MIT许可证 --免费使用、修改和分发。
伪造者 Drolosoft · *我们希望存在的工具*