Memory Journal MCP Server

🚀 智能相冊日記 MCP 服務器

智能相冊日記 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> 替換為實際的用戶名和克隆目錄路徑。

啟動服務器

1. 確保您的 Photos 庫已加載到 macOS。
2. 打開終端並導航至服務器目錄：

cd /Users/<YOUR_DEVICE_USERNAME>/memory-journal-mcp-server

3. 運行服務器：

uv run server.py

✨ 主要特性

• 位置搜索：輕鬆找到特定地點的相片。🌍
• 標籤搜索：按關鍵詞或標籤（如“生日”、“海灘”或“度假”）搜索相片。🎉
• 人物搜索：快速定位包含特定人物的相片。👥
• 相片分析：發現有趣的洞察，例如您最常拍照的時間和日期。itime
• 模糊匹配：不確定確切名稱？無需擔心！該服務器支持模糊匹配以增加靈活性。🔍

💻 使用示例

基礎用法

以下是一些使用服務器進行相片搜索的基礎命令示例：

# 位置搜索
location-search 紐約
# 標籤搜索
label-search 生日
# 人物搜索
person-search 王偉
# 相片分析
photo-analysis

高級用法

回憶家庭時光

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

person-search 家人

搜索旅行照片

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

location-search 京都

回顧生日派對

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

label-search 生日

📚 詳細文檔

啟發來源

本項目啟發來源於 burningion/video-editing-mcp，特別感謝 @burningion 提出使用 MCP 進行創意媒體管理的偉大構想！

注意事項

• 確保 Photos 庫已加載至 macOS。
• 儘量提供具體搜索詞以獲得更精準的結果。
• 利用模糊匹配功能，即使拼寫有誤也能找到相關結果。

通過以上步驟和工具，您可以輕鬆管理、搜索並分析您的相片庫，享受智能相冊帶來的便利！