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 中，以獲得最佳體驗。
• 搜索時儘量使用具體關鍵詞，以提高結果的準確性。
• 利用模糊匹配功能處理不確定的情況，提升搜索效率。