关键词

照片管理照片搜索照片分析macOS照片媒体管理

使用说明

项目简介

Smart Photo Journal MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器应用，旨在帮助用户更方便地搜索和分析 macOS 系统自带的照片库。通过集成到支持 MCP 协议的客户端（如 Claude Desktop），用户可以使用自然语言指令，利用服务器提供的工具来查找特定照片、分析照片拍摄习惯等。

主要功能点

  • 地点搜索：允许用户根据照片的拍摄地点查找照片，例如搜索“在巴黎拍摄的照片”。
  • 标签搜索：允许用户根据照片的标签或关键词查找照片，例如搜索“标记为生日的照片”或“包含狗的照片”。
  • 人物搜索：允许用户查找包含特定人物的照片，例如搜索“包含朋友的照片”。
  • 照片分析：提供照片库的分析功能，例如统计照片拍摄的时间分布，帮助用户了解自己的拍摄习惯。

安装步骤

  1. 环境准备：

    • 确保你使用的是 macOS 操作系统，并且已经设置了照片库。
    • 安装 uv 包管理器。你可以使用 pip 安装：'pip install uv' (或者参考 uv 官方文档进行安装)。

  2. 下载代码：

    • 打开终端，克隆仓库到本地： 
      git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server

  3. 安装依赖：

    • 在仓库目录下，使用 uv 安装项目依赖： 
      uv sync

服务器配置

要将 Smart Photo Journal MCP Server 集成到 MCP 客户端（例如 Claude Desktop），你需要配置客户端以连接到此服务器。以下是 Claude Desktop 客户端的配置示例，你需要将此配置添加到 Claude Desktop 的配置文件中（通常是 '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"
      ]
    }
  }
}

配置参数说明：

  • 'server name': '"smart-photo-journal"' （服务器名称，客户端通过此名称识别和连接服务器）
  • 'command': '"/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv"' （启动服务器的命令，这里使用 'uv' 运行器来执行 Python 脚本。请将 '<YOUR_DEVICE_USERNAME>' 替换为你的 macOS 用户名，并确保 'uv' 可执行文件位于指定的路径 '/Users/<YOUR_DEVICE_USERNAME>/.local/bin/uv' 下。如果 'uv' 安装路径不同，请替换为正确的路径。）
  • 'args': 启动命令的参数列表：
    • '"--directory"': '"/Users/<PATH_TO_CLONED_DIR>/memory-journal-mcp-server"' （指定服务器代码所在的目录。请将 '<PATH_TO_CLONED_DIR>' 替换为你克隆 'memory-journal-mcp-server' 仓库的本地路径。）
    • '"run"': '"run"' （使用 'uv run' 命令来运行 Python 脚本。）
    • '"server.py"': '"server.py"' （指定要运行的服务器脚本文件是 'server.py'。）

基本使用方法

  1. 启动服务器：

    • 你可以通过以下两种方式启动服务器：
      • 手动启动：在终端中，进入仓库目录 'memory-journal-mcp-server'，运行命令 'uv run server.py'。
      • 通过 MCP 客户端启动：配置好 MCP 客户端后，客户端通常会自动启动配置的 MCP 服务器。例如，启动 Claude Desktop 客户端后，如果配置正确，Smart Photo Journal MCP Server 也会随之启动。

  2. 客户端连接和使用：

    • 确保你的 MCP 客户端（如 Claude Desktop）已正确配置并连接到 "smart-photo-journal" 服务器。
    • 在客户端中，你可以使用自然语言指令来调用服务器提供的工具。例如，你可以输入类似 “搜索在东京拍摄的照片”、“查找标签为 ‘旅行’ 的照片”、“分析我的照片拍摄习惯” 等指令，客户端会将这些指令转换为对 MCP 服务器工具的调用，并返回照片搜索或分析结果。

注意：首次启动服务器时，macOS 可能会弹出权限请求，询问是否允许服务器访问你的照片库。请务必授权，否则服务器将无法正常工作。所有照片数据处理均在本地进行，不会上传到外部服务器。

信息

分类

桌面与硬件

访问项目