날짜, 위치, 라벨 및 이름을 통해 Apple Photos 라이브러리를 검색 한 다음 Codex 또는 다른 로컬 MCP 클라이언트의 단축 목록을 만들 미리보기를 볼 수 있습니다.

불타는 / 비디오 편집 - mcp에 의해 영감을.

설치

요구 사항 : macOS, Apple 사진 라이브러리, Python 3.11+ 및 uv.

서버는 기본적으로 Last-opened Photos library를 사용합니다. PHOTO_LIBRARY_PATH]를 설정하여 특정 .photoslibrary 디렉토리를 선택합니다. 자동 라이브러리 발견이 Photos preferences 파일을 읽을 수 없을 때 유용합니다.

ChatGPT, Codex 및 기타 데스크탑 앱

ChatGPT 데스크탑, Codex Desktop/CLI, Claude Desktop 및 Cursor에 대한 데스크톱 설정 가이드를 시작합니다. 완전한 구성 예제, macOS 권한, 개인 정보 보호 관리 및 첫 번째 검색 체크리스트가 포함되어 있습니다. 이 서버는 Local stdio, not HTTP URL; 로컬 필름 편집기는 별도의 옵션 응용 프로그램입니다.

Codex Desktop / CLI 빠른 시작

이 추가 ~/.codex/config.toml, 당신의 Mac에서 절대 경로 사용:

uv] command -v uv로 실행할 수 있습니다. 설정 편집 후 클라이언트를 재시작합니다. 공식 Codex MCP 구성 문서를 참조하십시오.

Claude 데스크탑 빠른 시작

Smart Photo Journal MCP Server

Search your Apple Photos library by date, location, labels and named people, then view previews to make a shortlist in Codex or another local MCP client.

Inspired by burningion/video-editing-mcp.

Install

Requirements: macOS, an Apple Photos library, Python 3.11+, and uv.

git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server
uv sync --locked --no-dev

The server uses the last-opened Photos library by default. Set PHOTO_LIBRARY_PATH to select a specific .photoslibrary directory. This is useful when automatic library discovery cannot read the Photos preferences file.

ChatGPT, Codex and other desktop apps

Start with the desktop setup guide for ChatGPT Desktop, Codex Desktop/CLI, Claude Desktop and Cursor. It includes complete configuration examples, macOS permissions, privacy controls and a first-search checklist. This server uses local stdio, not an HTTP URL; the local film editor is a separate optional application.

Codex Desktop / CLI quick start

Add this to ~/.codex/config.toml, using absolute paths on your Mac:

[mcp_servers.smart-photo-journal]
command = "/absolute/path/to/uv"
args = ["--directory", "/absolute/path/to/memory-journal-mcp-server", "run", "--locked", "--no-dev", "server.py"]
startup_timeout_sec = 120
tool_timeout_sec = 180

[mcp_servers.smart-photo-journal.env]
PHOTO_LIBRARY_PATH = "/Users/YOUR_USERNAME/Pictures/Photos Library.photoslibrary"

Find the uv executable with command -v uv. Restart the client after editing its configuration. See the official Codex MCP configuration documentation.

Claude Desktop quick start

Merge this entry into Claude Desktop’s existing configuration. See the setup guide for the configuration-file location. Do not replace your other servers. For Cursor, use examples/cursor.json, which explicitly sets type to stdio, and follow the Cursor setup steps.

{
  "mcpServers": {
    "smart-photo-journal": {
      "command": "/absolute/path/to/uv",
      "args": ["--directory", "/absolute/path/to/memory-journal-mcp-server", "run", "--locked", "--no-dev", "server.py"],
      "env": {
        "PHOTO_LIBRARY_PATH": "/Users/YOUR_USERNAME/Pictures/Photos Library.photoslibrary"
      }
    }
  }
}

macOS permissions and startup