🚀 智能照片日志 MCP 服务器
智能照片日志 MCP 服务器是一款强大的工具，它能帮助您轻松搜索和分析相片库。无论是重温家庭美好时刻，还是查找特定与朋友的照片，都能轻松实现，让您的照片管理变得高效又有趣！🎉
🚀 快速开始
灵感来源
本项目的灵感源自 burningion/video-editing-mcp。特别感谢 @burningion 提出使用 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//.local/bin/uv" ,
"args": [
"--directory",
"/Users//memory-journal-mcp-server" ,
"run",
"server.py"
]
}
}
}
- 使用以下命令或直接打开 Claude Desktop 启动服务器：
uv run server.py
⚠️ 重要提示
请将
和替换为您实际的设备用户名和克隆目录的路径。启动服务器时，您会收到一个弹出窗口，提示您授权服务器访问您的照片。该服务器仅在本地运行，除了 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 中已加载。
- 尽可能具体地进行搜索查询，以获得更准确的结果。
- 在不确定确切名称时，可使用模糊匹配功能。