📸 Smart Photo Journal MCP Server

📸 Smart Photo Journal MCP 服务

Smart Photo Journal 是一款 MCP 服务，旨在通过强大、直观的工具帮助你搜索和分析照片库。无论你是想重温家庭时光，还是寻找与朋友的某张特定照片，这款服务都能帮上忙！🎉

灵感来源： burningion/video-editing-mcp 特别感谢 @burningion 提出了将 MCP 用于创意媒体管理的创新想法！

🎯 功能

• 位置搜索： 轻松查找来自特定地点的照片。🌍
• 标签搜索： 按关键词或标签搜索照片，例如“生日”“海滩”或“度假”。🎉
• 人物搜索： 快速查找包含特定人物的照片。👥
• 照片分析： 发现有趣的信息，例如最常拍照的时段和日期。🕰️
• 模糊匹配： 不确定确切名称？别担心！服务支持模糊匹配，灵活查找。🔍

🚀 快速开始

前提条件

1. 确保你使用的是装有“照片”图库的 macOS。
2. 安装 uv，用于管理依赖项并运行服务。

安装

1. 克隆仓库：

   git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
   cd memory-journal-mcp-server
   

2. 使用 uv 安装依赖项：

   uv sync
   

3. 配置 MCP 服务。使用以下配置更新你的 claude_desktop_config.json：

   {
     "mcpServers": {
       "smart-photo-journal": {
         "command": "/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv",
         "args": [
           "--directory",
           "/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server",
           "run",
           "server.py"
         ]
       }
     }
   }
   

4. 使用以下命令启动服务，或直接打开 Claude Desktop：

   uv run server.py
   

注意： 将 <YOUR_DEVICE_USERNAME> 和 <PATH_TO_CLONED_DIR> 替换为你的实际设备用户名和克隆目录的路径。 系统会弹出窗口，授权服务访问你的照片。数据只会保留在本地，不会与 Claude 服务以外的任何人共享。

MCP 服务初始化

服务启动后，你会看到：

Starting Smart Photo Journal MCP server.

现在可以开始处理你的照片查询了！🎉

---

🛠️ 使用方法

可用工具

1. 位置搜索

   • 描述：查找在特定地点拍摄的照片。
   • 输入示例：

     {
       "location": "Udaipur"
     }
     

   • 预期输出：

     找到 5 张来自 Udaipur 的照片：
     📷 IMG_1234.jpg
     ...
     

2. 标签搜索

   • 描述：按标签或关键词搜索照片。
   • 输入示例：

     {
       "label": "Birthday"
     }
     

   • 预期输出：

     标记为 'Birthday' 的照片（找到 3 张）：
     📷 IMG_5678.jpg
     ...
     

3. 人物搜索

   • 描述：查找包含特定人物的照片。
   • 输入示例：

     {
       "person": "Maa"
     }
     

   • 预期输出：

     包含 Maa 的照片（找到 10 张）：
     📷 IMG_9101.jpg
     ...
     

4. 照片分析

   • 描述：分析照片库中的规律，例如最常拍照的时段或日期。
   • 输入示例：

     {}
     

   • 预期输出：

     📸 拍照规律：
     照片总数：200
     ...
     

---

📚 使用场景示例

1. 家庭与朋友相册整理

想把所有家庭时光汇集到一处？使用 people-search 工具，输入“Papa”“Mom”或“Any Friend”等姓名，查找包含特定人物的照片。

2. 假期精彩瞬间

使用 location-search 工具搜索度假目的地的照片。

3. 重温往日乐趣

想看看过去生日时拍的照片？使用 label-search 搜索“Birthday”，重温欢乐时光！

4. 了解你的摄影习惯

使用 photo-analysis 工具了解你通常在何时何地拍摄照片，并据此规划下一次拍摄！

---

⚡ 最佳效果提示

• 确保 macOS 中已加载你的 Photos 资料库。
• 搜索查询越具体，结果越准确。
• 不确定确切名称时，使用模糊匹配以增加灵活性。