Icloud Photos

📸 Smart Photo Journal MCP Server

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

Inspired by: burningion/video-editing-mcp Special thanks to @burningion for the great idea of using MCP for creative media management!

✨ Features

• Location Search: Easily find photos taken at specific locations. 🌍
• Tag Search: Search for photos by keywords or tags (e.g., "birthday", "beach", or "vacation"). 🎉
• Person Search: Quickly locate photos containing specific individuals. 👥
• Photo Analysis: Discover interesting insights, such as the most frequent times and dates you take photos. ⏱️
• Fuzzy Matching: Not sure of the exact name? No worries! The server supports fuzzy matching for flexibility. 🔍

🚀 Quick Start

Prerequisites

1. Ensure your device is running macOS and has a Photos library.
2. Install uv to manage dependencies and run the server.

Installation Steps

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 file 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 using the following command or by directly opening Claude Desktop:

   uv run server.py
   

⚠️ Important Note

Please replace <YOUR_DEVICE_USERNAME> and <PATH_TO_CLONED_DIR> with your actual device username and the path to the cloned directory.

📚 Documentation

• Location Search: Enter a geographical location to quickly find relevant photos.
• Tag Search: Use keywords or tags for precise searches. For example, enter "birthday" to get all birthday-related photos.
• Person Search: Search for photos of specific individuals by their names or other identifiers.
• Photo Analysis: Get an analysis of your photo-taking habits, including the most frequent shooting times and popular locations.
• Fuzzy Matching: When you're unsure of the search keyword, use approximate words for the search, and the system will automatically recommend relevant results.

📋 Usage Scenarios

1. Family Memories

• Search for photos of specific family members, such as "mom" or "dad", to quickly find all related photos.
• Recall birthday parties from the past few years by entering the tag "birthday".

2. Travel Records

• Search by travel destinations, such as "Paris" or "Tokyo", to organize your travel memories.
• Analyze your shooting frequency in different travel destinations to understand your preferences.

3. Work Needs

• For photographers or content creators, quickly classify and manage materials by tags.
• Use the photo analysis function to optimize your shooting plans and time arrangements.

💡 Usage Tip

• Ensure your Photos library is loaded into macOS for the best experience.
• Try to use specific keywords when searching to improve the accuracy of the results.
• Utilize the fuzzy matching function to handle uncertain situations and enhance search efficiency.