Smart Photo Journal MCP Server

📸 智能照片日志 MCP 服务器

Smart Photo Journal是一款 MCP 服务器，旨在帮助您使用强大直观的工具搜索和分析照片库。无论您是想回忆家庭时光，还是想寻找与朋友的特定合影，这款服务器都能满足您的需求！🎉

灵感来自： burningion/video-editing-mcp向@burningion致以崇高的敬意，感谢他提出的使用 MCP 进行创意媒体管理的创新想法！

🎯 功能

• **位置搜索：**轻松查找特定地点的照片。🌍
• **标签搜索：**按关键字或标签搜索照片，例如“生日”、“海滩”或“假期”。🎉
• **人物搜索：**快速找到特定人物的照片。👥
• **照片分析：**发现有趣的见解，例如拍摄照片最受欢迎的时间和日期。🕰️
• **模糊匹配：**不确定具体名称？别担心！服务器支持模糊匹配，更加灵活。🔍

🚀 入门

先决条件

1. 确保您的 macOS 具有照片库。
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 服务器初始化

当服务器启动时，您将看到：

现在可以处理您的照片查询了！🎉

🛠️ 使用方法

可用工具

1. 位置搜索
   • 描述：查找在特定位置拍摄的照片。
   • 输入示例：
     { "location": "Udaipur" }
   • 预期输出：
     Found 5 photos from Udaipur: 📷 IMG_1234.jpg ...
2. 标签搜索
   • 描述：通过标签或关键字搜索照片。
   • 输入示例：
     { "label": "Birthday" }
   • 预期输出：
     Photos labeled as 'Birthday' (3 found): 📷 IMG_5678.jpg ...
3. 人物搜索
   • 描述：查找包含特定人物的照片。
   • 输入示例：
     { "person": "Maa" }
   • 预期输出：
     Photos with Maa (10 found): 📷 IMG_9101.jpg ...
4. 照片分析
   • 描述：分析照片库中的模式，例如最常见的拍照时间或日期。
   • 输入示例：
     {}
   • 预期输出：
     📸 Photo Taking Patterns: Total Photos: 200 ...

📚 示例用例

1.家人和朋友相册管理器

想把所有家庭瞬间都聚集到一起吗？使用people-search工具，输入“爸爸”、“妈妈”或“任何朋友”等名字，就能找到特定人物的照片。

2.假期亮点

使用location-search工具搜索您的度假目的地的照片。

3.怀旧乐趣

好奇你过去的生日照片吗？使用“生日” label-search ，重温当年的乐趣吧！

4.了解你的摄影习惯

使用photo-analysis工具，了解您大部分照片的拍摄时间和地点。据此规划您的下一次拍摄！

⚡ 获得最佳效果的秘诀

• 确保您的照片库已在 macOS 中加载。
• 尽可能具体地进行搜索查询以获得更准确的结果。
• 当您不确定确切的名称时，可以使用模糊匹配来获得灵活性。