Siddhant K Code Memory Journal MCP Server

🚀 智能照片日志 MCP 服务器

智能照片日志 MCP 服务器是一款强大的工具，它能帮助您轻松搜索和分析相片库。无论是重温家庭美好时刻，还是查找特定与朋友的照片，都能轻松实现，让您的照片管理变得高效又有趣！🎉

🚀 快速开始

灵感来源

本项目的灵感源自 burningion/video-editing-mcp。特别感谢 @burningion 提出使用 MCP 进行创造性媒体管理的创新想法！

先决条件

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 服务器。

此时，服务器已准备好处理您的照片查询！🎉

✨ 主要特性

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

💻 使用示例

基础用法

位置搜索

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

{
  "location": " udaipur"
}

• 预期输出：

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

标签搜索

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

{
  "label": "Birthday"
}

• 预期输出：

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

人物搜索

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

{
  "person": "Alice"
}

• 预期输出：

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

照片分析

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

{
  "analysis": "summary"
}

• 预期输出：

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

💡 使用建议

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