Memory Journal MCP Server

🚀 Smart Photo Journal MCP Server

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

Inspiration Source: 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 that include specific individuals. 👥
• Photo Analysis: Discover interesting insights, such as the most frequent times and dates you take photos. itime
• Fuzzy Matching: Not sure of the exact name? No worries! The server supports fuzzy matching for added 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

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 open Claude Desktop directly:

uv run server.py

⚠️ Important Note

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

💻 Usage Examples

Basic Usage

Starting the Server

1. Ensure your Photos library is loaded on macOS.
2. Open the terminal and navigate to the server directory:

cd /Users/<YOUR_DEVICE_USERNAME>/memory-journal-mcp-server

3. Run the server:

uv run server.py

Advanced Usage

Location Search

• Command: location-search <location>
• Example: location-search New York
• Description: Search for all photos taken at a specific location.

Tag Search

• Command: label-search <tag>
• Example: label-search birthday
• Description: Find photos by the specified tag.

Person Search

• Command: person-search <name>
• Example: person-search Wang Wei
• Description: Search for photos that include a specific person.

Photo Analysis

• Command: photo-analysis
• Example: photo-analysis
• Description: Analyze the shooting time, location, and frequency, and output statistical results.

Example Use Cases

1. Reminiscing Family Time

Use person-search to find photos that include family members:

person-search family

2. Searching for Travel Photos

Find photos taken during your travels using location-search:

location-search Kyoto

3. Reviewing Birthday Parties

Use label-search to find photos related to birthdays:

label-search birthday

💡 Usage Tip

• Ensure your Photos library is loaded on macOS.
• Provide specific search terms for more accurate results.
• Utilize the fuzzy matching feature to find relevant results even if the spelling is incorrect.

With the above steps and tools, you can easily manage, search, and analyze your photo library and enjoy the convenience of the smart photo journal!