📸 智能照片日志 MCP 服务器

智能照片日志 是一个 MCP 服务器，旨在通过强大的、直观的工具帮助您搜索和分析您的相片库。无论您是回忆家庭时刻还是寻找特定与朋友一起的照片，这个服务器都能让您轻松搞定！🎉

灵感来源: burningion/video-editing-mcp 大 shoutout 给 @burningion 因为使用 MCP 进行创造性媒体管理的创新想法！

🎯 功能

• 位置搜索: 轻松找到特定地点的相片。🌍
• 标签搜索: 按关键词或标签（如“生日”、“海滩”或“假期”）搜索相片。🎉
• 人物搜索: 快速定位包含特定人物的相片。👥
• 照片分析: 发现有趣的见解，例如您拍摄照片最热门的时间和日期。chrono️
• 模糊匹配: 不确定确切名称？不用担心！该服务器支持模糊匹配以提供灵活性。🔍

🚀 开始使用

先决条件

1. 确保您在 macOS 上有 Photos 库。
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 服务器初始化

当服务器启动时，您将看到：

正在启动智能照片日志 MCP 服务器。

现在准备好处理您的照片查询了！🎉

🛠️ 使用方法

可用工具

1. 位置搜索

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

     {
       "location": " udaipur"
     }
     

   • 预期输出：

     在 Udaipur 找到 5 张照片：
     📷 IMG_1234.jpg
     ...
     

2. 标签搜索

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

     {
       "label": "Birthday"
     }
     

   • 预期输出：

     找到标签为“Birthday”的照片：
     📷 IMG_5678.jpg
     ...
     

3. 人物搜索

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

     {
       "person": "Alice"
     }
     

   • 预期输出：

     找到 Alice 的照片：
     📷 IMG_9012.jpg
     ...
     

4. 照片分析

   • 描述：了解您拍摄照片的时间、地点和频率。
   • 输入示例：

     {
       "analysis": "summary"
     }
     

   • 预期输出：

     - 最常拍摄的日期：2023-10-01
     - 最常拍摄的位置：New York
     - 拍摄最活跃的时间段：傍晚时分
     

⚡ 使用技巧

• 确保您的 Photos 库在 macOS 中已加载。
• 尽可能具体地进行搜索查询以获得更准确的结果。
• 在不确定确切名称时使用模糊匹配。