Smart Photo Journal MCP Server

Servidor MCP de diario fotográfico inteligente

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 ayudará! 🎉

Inspirado por: 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 de ubicación: Encuentra fotos de lugares específicos con facilidad. 🌍
• Búsqueda por etiquetas: Busca fotos por palabras clave o etiquetas como "Cumpleaños", "Playa" o "Vacaciones". 🎉
• Búsqueda de personas: localiza rápidamente fotos que incluyan a personas específicas. 👥
• Análisis de fotos: descubre información interesante, como los días y horarios más populares para tus sesiones de fotos. 🕰️
• Coincidencia aproximada: ¿No estás seguro del nombre exacto? ¡No te preocupes! El servidor admite coincidencias aproximadas para mayor flexibilidad. 🔍

🚀 Empezando

Prerrequisitos

1. Asegúrate de tener macOS con una biblioteca de fotos.
2. Instale uv para administrar las dependencias y ejecutar el servidor.

Instalación

1. Clonar el repositorio:
   git clone https://github.com/Siddhant-K-code/memory-journal-mcp-server.git cd memory-journal-mcp-server
2. Instalar dependencias usando uv :
   uv sync
3. Configurar el servidor MCP. Actualizar 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. Inicie el servidor con el siguiente comando o simplemente abra Claude Desktop:
   uv run server.py

Nota: Reemplace <YOUR_DEVICE_USERNAME> y <PATH_TO_CLONED_DIR> con el nombre de usuario de su dispositivo y la ruta al directorio clonado. Aparecerá una ventana emergente para autorizar al servidor a acceder a sus fotos. El acceso será local y no se compartirán datos con nadie más que con los servicios de Claude.

Inicialización del servidor MCP

Cuando se inicie el servidor verás:

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

🛠️ Uso

Herramientas disponibles

1. Búsqueda de ubicación
   • Descripción: Encuentra fotos tomadas en una ubicación específica.
   • Ejemplo de entrada:
     { "location": "Udaipur" }
   • Resultado esperado:
     Found 5 photos from Udaipur: 📷 IMG_1234.jpg ...
2. Búsqueda de etiquetas
   • Descripción: Busca fotos por etiquetas o palabras clave.
   • Ejemplo de entrada:
     { "label": "Birthday" }
   • Resultado esperado:
     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" }
   • Resultado esperado:
     Photos with Maa (10 found): 📷 IMG_9101.jpg ...
4. Análisis de fotografías
   • Descripción: Analice patrones en su biblioteca de fotografías, como los horarios o días más comunes para las sesiones de fotos.
   • Ejemplo de entrada:
     {}
   • Resultado esperado:
     📸 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á", "Mamá" o "Algún amigo" para encontrar fotos con personas específicas.

2. Lo más destacado de las vacaciones

Busque fotos de su destino de vacaciones utilizando la herramienta location-search .

3. Diversión retro

¿Te interesan las fotos de tus cumpleaños anteriores? Usa label-search con "Cumpleaños" y ¡revive la diversión!

4. Comprende tus hábitos fotográficos

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

⚡ Consejos para obtener mejores resultados

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