MCP HubMCP Hub
Siddhant-K-code

memory-journal-mcp-server

by: Siddhant-K-code

MCP server designed to help you search and analyze your photo library (iCloud)

16created 26/01/2025
Visit
iCloud
photos

📌Overview

Purpose: Smart Photo Journal is an MCP server designed to enhance photo library management by enabling efficient searching and analysis of personal photos.

Overview: This server offers intuitive tools for users to easily locate and analyze their photos, making it perfect for both nostalgic browsing and efficient searching of specific images. It is inspired by the creative approach to media management, allowing for a seamless experience in organizing and reviewing photo collections.

Key Features:

  • Location Search: Easily find photos taken at specific locations, enhancing the ability to recall memories tied to specific places.

  • Label Search: Search photos using keywords or labels, such as "Birthday" or "Beach," allowing for quick access to themed collections.

  • People Search: Locate photos featuring specific individuals, making it easy to gather images of family and friends.

  • Photo Analysis: Provides insights into photo-taking patterns, revealing popular times and dates for user shoots, which can help in planning future photography.

  • Fuzzy Matching: Supports flexible searches even if the user isn’t sure of the exact name, thus improving search accuracy and user experience.

📸 Smart Photo Journal MCP Server

Smart Photo Journal is an MCP server designed to help you search and analyze your photo library with powerful, intuitive tools. Whether you're reminiscing about family moments or looking for a specific photo with friends, this server has got you covered!

Inspired by: burningion/video-editing-mcp
A huge shoutout to @burningion for the innovative idea of using MCP for creative media management!

🎯 Features

  • Location Search: Find photos from specific places with ease.
  • Label Search: Search photos by keywords or labels like "Birthday," "Beach," or "Vacation."
  • People Search: Quickly locate photos featuring specific people.
  • Photo Analysis: Discover insights like the most popular times and days for your photo shoots.
  • Fuzzy Matching: Supports fuzzy matching for flexible search even if unsure of the exact name.

🚀 Getting started

Prerequisites

  1. Ensure you have macOS with a Photos library.
  2. Install uv to manage dependencies and run the server.

Installation

  1. Clone the repository:

    git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git
cd memory-journal-mcp-server

  2. Install dependencies using uv:

    uv sync

  3. Configure the MCP server. Update your claude_desktop_config.json with the following configuration:

    {
  "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. Start the server with the following command or open Claude Desktop:

    uv run server.py

Note: Replace <YOUR_DEVICE_USERNAME> and <PATH_TO_CLONED_DIR> with your actual device username and the path to the cloned directory. You will get a popup to authorize the server to access your photos. It is local only; no data will be shared aside from Claude services.

MCP Server Initialization

When the server starts, you'll see:

Starting Smart Photo Journal MCP server.

It's now ready to process your photo queries!

🛠️ Usage

Available Tools

  1. Location Search

    • Description: Find photos taken in a specific location.
    • Input Example: 
      {
  "location": "Udaipur"
}
    • Expected Output: 
      Found 5 photos from Udaipur:
IMG_1234.jpg
...

  2. Label Search

    • Description: Search for photos by labels or keywords.
    • Input Example: 
      {
  "label": "Birthday"
}
    • Expected Output: 
      Photos labeled as 'Birthday' (3 found):
IMG_5678.jpg
...

  3. People Search

    • Description: Find photos containing specific people.
    • Input Example: 
      {
  "person": "Maa"
}
    • Expected Output: 
      Photos with Maa (10 found):
IMG_9101.jpg
...

  4. Photo Analysis

    • Description: Analyze patterns in your photo library, such as common times or days for photo shoots.
    • Input Example: 
      {}
    • Expected Output: 
      Photo Taking Patterns:
Total Photos: 200
...

📚 Example Use-Cases

1. Family & Friends Album Organizer

Gather all your family moments by using the people-search tool with names like "Papa," "Mom," or any friend to find photos with specific people.

2. Vacation Highlights

Search for photos from your vacation destination using the location-search tool.

3. Throwback Fun

Use label-search with "Birthday" to find and relive your past birthday photos.

4. Understand Your Photography Habits

Use the photo-analysis tool to understand when and where you take most of your photos and plan your next shoot accordingly.

⚡ Tips for Best Results

  • Ensure your Photos library is loaded in macOS.
  • Be as specific as possible with search queries for more accurate results.
  • Use fuzzy matching when unsure of the exact name for flexible searching.