memory-journal-mcp-server

🚀 智能相册日记 MCP 服务器

智能相册日记 MCP 服务器是一款强大的工具，它能帮助您高效地搜索和分析相片库。无论是想重温家庭美好时光，还是快速找到与朋友的特定照片，该服务器都能轻松满足您的需求！🎉

启发来源：[burningion/video - editing - mcp](https://github.com/burningion/video - editing - mcp) 特别感谢 @burningion 提出使用 MCP 进行创意媒体管理的伟大构想！

✨ 主要特性

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

🚀 快速开始

前提条件

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
• 说明：分析拍摄时间、地点及频率，输出统计结果。

常见使用场景示例

回忆家庭时光

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

person - search 家人

搜索旅行照片

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

location - search 京都

回顾生日派对

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

label - search 生日

📚 详细文档

📝 注意事项

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

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