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 中已加載。
• 儘可能具體地進行搜索查詢，以獲得更準確的結果。
• 在不確定確切名稱時，可使用模糊匹配功能。