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。
• 尽量提供具体搜索词以获得更精准的结果。
• 利用模糊匹配功能，即使拼写有误也能找到相关结果。

通过以上步骤和工具，您可以轻松管理、搜索并分析您的相片库，享受智能相册带来的便利！