📸 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 fun insights like the most popular times and days for your photo shoots. 🕰️
• Fuzzy Matching: Not sure of the exact name? Don't worry! The server supports fuzzy matching for flexibility. 🔍

🚀 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//.local/bin/uv",
         "args": [
           "--directory",
           "/Users//memory-journal-mcp-server",
           "run",
           "server.py"
         ]
       }
     }
   }

4. Start the server with following command or just open Claude Desktop:

uv run server.py

> Note: Replace `` and `` 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 will be in local only, and no data will be shared with anyone except 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

{
       "location": "Udaipur"
     }

Found 5 photos from Udaipur:
     📷 IMG_1234.jpg
     ...

2. Label Search

{
       "label": "Birthday"
     }

Photos labeled as 'Birthday' (3 found):
     📷 IMG_5678.jpg
     ...

3. People Search

{
       "person": "Maa"
     }

Photos with Maa (10 found):
     📷 IMG_9101.jpg
     ...

4. Photo Analysis

{}

📸 Photo Taking Patterns:
     Total Photos: 200
     ...

📚 Example Use-Cases

1. Family & Friends Album Organizer

Want to gather all your family moments in one place? Use the `people-search` tool with names like "Papa" or "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

Curious about your past birthday photos? Use `label-search` with "Birthday" and relive the fun!

4. Understand Your Photography Habits

Use the `photo-analysis` tool to understand when and where you take most of your photos. 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 for flexibility when you're unsure of the exact name.