Smart Photo Journal MCP Server

📸 Smart Photo Journal MCP Server

Smart Photo Journal es un servidor MCP diseñado para ayudarte a buscar y analizar tu biblioteca de fotos con herramientas potentes e intuitivas. Ya sea que estés recordando momentos familiares o buscando una foto específica con amigos, ¡este servidor te tiene cubierto! 🎉

Inspirado en: burningion/video-editing-mcp ¡Un gran agradecimiento a @burningion por la idea innovadora de usar MCP para la gestión creativa de medios!

🎯 Características

• Búsqueda por ubicación: Encuentra fotos de lugares específicos con facilidad. 🌍
• Búsqueda por etiqueta: Busca fotos por palabras clave o etiquetas como "Cumpleaños", "Playa" o "Vacaciones". 🎉
• Búsqueda de personas: Localiza rápidamente fotos con personas específicas. 👥
• Análisis de fotos: Descubre datos interesantes como los momentos y días más populares para tus sesiones de fotos. 🕰️
• Coincidencia difusa: ¿No estás seguro del nombre exacto? ¡No te preocupes! El servidor admite coincidencia difusa para mayor flexibilidad. 🔍

🚀 Primeros pasos

Requisitos previos

1. Asegúrate de tener macOS con una biblioteca de Fotos.
2. Instala uv para gestionar dependencias y ejecutar el servidor.

Instalación

1. Clona el repositorio:

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

2. Instala las dependencias usando uv:

   uv sync
   

3. Configura el servidor MCP. Actualiza tu claude_desktop_config.json con la siguiente configuración:

   {
     "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. Inicia el servidor con el siguiente comando o simplemente abre Claude Desktop:

   uv run server.py
   

Nota: Reemplaza <YOUR_DEVICE_USERNAME> y <PATH_TO_CLONED_DIR> con tu nombre de usuario real del dispositivo y la ruta al directorio clonado. Verás una ventana emergente para autorizar al servidor a acceder a tus fotos. Será solo local, y no se compartirán datos con nadie excepto con los servicios de Claude.

Inicialización del servidor MCP

Cuando el servidor se inicie, verás:

Starting Smart Photo Journal MCP server.

¡Ahora está listo para procesar tus consultas de fotos! 🎉

---

🛠️ Uso

Herramientas disponibles

1. Búsqueda por ubicación

   • Descripción: Encuentra fotos tomadas en una ubicación específica.
   • Ejemplo de entrada:

     {
       "location": "Udaipur"
     }
     

   • Salida esperada:

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

2. Búsqueda por etiqueta

   • Descripción: Busca fotos por etiquetas o palabras clave.
   • Ejemplo de entrada:

     {
       "label": "Birthday"
     }
     

   • Salida esperada:

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

3. Búsqueda de personas

   • Descripción: Encuentra fotos que contengan personas específicas.
   • Ejemplo de entrada:

     {
       "person": "Maa"
     }
     

   • Salida esperada:

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

4. Análisis de fotos

   • Descripción: Analiza patrones en tu biblioteca de fotos, como los momentos o días más comunes para sesiones de fotos.
   • Ejemplo de entrada:

     {}
     

   • Salida esperada:

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

---

📚 Ejemplos de casos de uso

1. Organizador de álbumes familiares y de amigos

¿Quieres reunir todos tus momentos familiares en un solo lugar? Usa la herramienta people-search con nombres como "Papá" o "Mamá" o "Cualquier amigo" para encontrar fotos con personas específicas.

2. Destacados de vacaciones

Busca fotos de tu destino de vacaciones usando la herramienta location-search.

3. Diversión retro

¿Sientes curiosidad por tus fotos de cumpleaños pasadas? Usa label-search con "Cumpleaños" y ¡revive la diversión!

4. Comprende tus hábitos fotográficos

Usa la herramienta photo-analysis para entender cuándo y dónde tomas la mayoría de tus fotos. ¡Planifica tu próxima sesión en consecuencia!

---

⚡ Consejos para mejores resultados

• Asegúrate de que tu biblioteca de Fotos esté cargada en macOS.
• Sé lo más específico posible con las consultas de búsqueda para obtener resultados más precisos.
• Usa coincidencia difusa para mayor flexibilidad cuando no estés seguro del nombre exacto.