Icloud Photos

🚀 智能照片日记 MCP 服务端

智能照片日记 MCP 服务端借助强大且直观的工具，助力你对相片库进行搜索与分析。无论是重温家庭美好时光，还是与朋友一同找寻特定照片，该服务端都能为你提供有力支持！🎉

🚀 快速开始

灵感来源与致谢

本项目灵感源自 burningion/video-editing-mcp，特别感谢 @burningion 提出运用 MCP 进行创意媒体管理的卓越构想！

入门指南

先决条件

• 确保设备运行 macOS 系统，且拥有 Photos 库。
• 安装 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> 替换为实际的用户名和克隆目录路径。

✨ 主要特性

• 位置搜索：能轻松找出特定地点的相片。🌍
• 标签搜索：可按关键词或标签（如“生日”“海滩”“假期”等）搜索相片。🎉
• 人物搜索：可快速定位包含特定人物的相片。👥
• 照片分析：能发现有趣洞察，例如拍摄最多的时段和日期。itime️
• 模糊匹配：若不确定确切名称也无妨，该服务端支持模糊匹配，提供搜索灵活性。🔍

💻 使用示例

基础用法

# 克隆仓库
git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server

# 安装依赖项
uv sync

# 启动服务端
uv run server.py

📚 详细文档

功能说明

• 位置搜索：输入地理位置，可快速找到相关相片。
• 标签搜索：使用关键词或标签进行精确查找，例如输入“生日”可获取所有生日相关照片。
• 人物搜索：通过人名或其他标识符搜索特定人物的相片。
• 照片分析：能获取拍摄习惯分析，包括最常拍摄的时间段和热门地点等信息。
• 模糊匹配：当不确定搜索关键词时，可使用近似词进行查找，系统会自动推荐相关结果。

使用场景

家庭回忆

• 搜索特定家庭成员的相片，如“妈妈”“爸爸”，可快速找到所有相关照片。
• 回顾过去几年的生日聚会，输入标签“生日”即可轻松定位。

旅行记录

• 按照旅行目的地进行搜索，如“巴黎”“东京”，可整理旅行回忆。
• 分析在不同旅行地的拍摄频率，了解自身偏好。

工作需求

• 对于摄影师或内容创作者，可通过标签快速分类和管理素材。
• 使用照片分析功能，优化拍摄计划和时间安排。

🔧 技术细节

本项目基于 macOS 系统和 Photos 库，使用 uv 管理依赖项并运行服务端。通过配置 claude_desktop_config.json 文件，将服务端集成到 Claude Desktop 中。同时，服务端支持多种搜索功能，包括位置搜索、标签搜索、人物搜索等，还具备照片分析和模糊匹配能力。

⚡ 小技巧

💡 使用建议

• 确保 Photos 库已加载到 macOS 中，以获得最佳体验。
• 搜索时尽量使用具体关键词，以提高结果的准确性。
• 利用模糊匹配功能处理不确定的情况，提升搜索效率。