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. 🔍

Related MCP server: mcp-osxphotos

🚀 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:

Starting Smart Photo Journal MCP server.

¡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.