📸 智能相册日记 MCP 服务器

智能相册日记 是一个 MCP 服务器，旨在通过强大的直观工具帮助您搜索和分析您的相片库。无论是回味家庭时光还是与朋友寻找特定照片，这个服务器都能满足您的需求！🎉

启发来源: burningion/video-editing-mcp 特别感谢 @burningion 提出使用 MCP 进行创意媒体管理的伟大构想！

🎯 功能

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

🚀 入门指南

prerequisites

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> 替换为实际的用户名和克隆目录路径。

📝 使用说明

启动服务器

1. 确保您的 Photos 库已加载到 macOS。
2. 打开终端并导航至服务器目录：

   cd /Users/<YOUR_DEVICE_USERNAME>/memory-journal-mcp-server
   

3. 运行服务器：

   uv run server.py
   

💡 工具指南

位置搜索

• 命令: location-search <地点>
• 示例: location-search 纽约
• 说明: 搜索特定位置的所有相片。

标签搜索

• 命令: label-search <标签>
• 示例: label-search 生日
• 说明: 按指定标签查找相片。

人物搜索

• 命令: person-search <姓名>
• 示例: person-search 王伟
• 说明: 根据人名搜索包含该人物的相片。

相片分析

• 命令: photo-analysis
• 示例: photo-analysis
• 说明: 分析拍摄时间、地点及频率，输出统计结果。

📚 示例用例

1. 回忆家庭时光

使用 person-search 查找包含家人的相片：

person-search 家人

2. 搜索旅行照片

通过 location-search 找到旅行地的相片：

location-search 京都

3. 回顾生日派对

利用 label-search 查找生日相关的相片：

label-search 生日

📝 注意事项

• 确保 Photos 库已加载至 macOS。
• 尽量提供具体搜索词以获得更精准的结果。
• 利用模糊匹配功能，即使拼写有误也能找到相关结果。

通过以上步骤和工具，您可以轻松管理、搜索并分析您的相片库，享受智能相册带来的便利！