照片搜索分析服务器

Smart Photo Journal是一个MCP服务器,提供基于位置、标签和人物的照片搜索功能,并支持照片库分析。

  • by Siddhant-K-code
  • Python
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 Siddhant-K-code/memory-journal-mcp-server

使用说明

📸 智能照片日志MCP服务器

智能照片杂志 是一个MCP服务器,旨在帮助您使用强大、直观的工具搜索和分析照片库。无论您是在回忆家庭时刻,还是在寻找与朋友的特定照片,这台服务器都能满足您的需求! 🎉

灵感来源: 烧录/视频编辑mcp 一声巨大的呐喊 @ Burningion公司 感谢使用MCP进行创意媒体管理的创新理念!

🎯 特性

  • 位置搜索: 轻松查找特定地点的照片。 🌍
  • 标签搜索: 按关键字或标签搜索照片,如“生日”、“海滩”或“度假”🎉
  • 人员搜索: 快速定位特定人物的照片。 👥
  • 照片分析: 发现有趣的见解,如最受欢迎的照片拍摄时间和日期。 🕰️
  • 模糊匹配: 不知道确切的名字?别担心!服务器支持模糊匹配以提高灵活性。 🔍

🚀 入门

先决条件

  1. 确保您的macOS带有照片库。
  2. 安装 紫外线 管理依赖关系并运行服务器。

安装

  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> 使用您的实际设备用户名和克隆目录的路径。 您将看到一个弹出窗口,授权服务器访问您的照片。它将仅在本地使用,除克劳德服务外,不会与任何人共享任何数据。

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中加载。
  • 尽可能具体地进行搜索查询,以获得更准确的结果。
  • 当你不确定确切的名称时,使用模糊匹配以获得灵活性。