金大哥 - iCloud Photos MCP 详情

article

README

🚀 智能照片日记 MCP 服务端

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

🚀 快速开始

先决条件

确保你的设备运行 macOS 并拥有 Photos 库。
安装 uv 以管理依赖项并运行服务端。

安装步骤

克隆仓库:

git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server

使用 uv 安装依赖项:

uv sync

配置 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"
      ]
    }
  }
}

使用以下命令或直接打开 Claude Desktop 启动服务端:

uv run server.py

⚠️ 重要提示

请将 <YOUR_DEVICE_USERNAME> 和 <PATH_TO_CLONED_DIR> 替换为实际的用户名和克隆目录路径。

✨ 主要特性

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

💻 使用示例

基础用法

位置搜索

输入地理位置，快速找到相关的相片。

标签搜索

使用关键词或标签进行精确查找，例如输入“生日”以获取所有生日相关照片。

人物搜索

通过人名或其他标识符搜索特定人物的相片。

照片分析

获取你的拍摄习惯分析，包括最常拍摄的时间段和热门地点等信息。

模糊匹配

当不确定搜索关键词时，可以使用近似词进行查找，系统会自动推荐相关结果。

高级用法

家庭回忆

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

旅行记录

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

工作需求

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

📚 详细文档

灵感来源

灵感来自：burningion/video-editing-mcp 特别鸣谢 @burningion 提出使用 MCP 进行创意媒体管理的伟大构想！

💡 使用建议

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

iCloud Photos