📸 智能照片日志 MCP 服务器

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

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

🎯 功能

• **位置搜索：**轻松查找特定地点的照片。🌍

• **标签搜索：**按关键字或标签搜索照片，例如“生日”、“海滩”或“假期”。🎉

• **人物搜索：**快速找到特定人物的照片。👥

• **照片分析：**发现有趣的见解，例如拍摄照片最受欢迎的时间和日期。🕰️

• **模糊匹配：**不确定具体名称？别担心！服务器支持模糊匹配，更加灵活。🔍

Related MCP server: mcp-osxphotos

🚀 入门

先决条件

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 服务器初始化

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

Starting Smart Photo Journal MCP server.

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

🛠️ 使用方法

可用工具

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 中加载。

• 尽可能具体地进行搜索查询以获得更准确的结果。

• 当您不确定确切的名称时，可以使用模糊匹配来获得灵活性。