Smart Photo Journal MCP Server

Crie um diário de memórias a partir das suas fotos locais na biblioteca de Fotos do macOS.

Documentação

📸 Smart Photo Journal MCP Server

Smart Photo Journal é um servidor MCP projetado para ajudar você a pesquisar e analisar sua biblioteca de fotos com ferramentas poderosas e intuitivas. Esteja você relembrando momentos em família ou procurando uma foto específica com amigos, este servidor tem tudo o que você precisa! 🎉

Inspirado por: burningion/video-editing-mcp Um grande agradecimento a @burningion pela ideia inovadora de usar MCP para gerenciamento criativo de mídia!

🎯 Recursos

Busca por Localização: Encontre fotos de lugares específicos com facilidade. 🌍
Busca por Rótulos: Pesquise fotos por palavras-chave ou rótulos como "Aniversário", "Praia" ou "Férias". 🎉
Busca por Pessoas: Localize rapidamente fotos com pessoas específicas. 👥
Análise de Fotos: Descubra insights divertidos, como os horários e dias mais populares para suas sessões de fotos. 🕰️
Correspondência Difusa: Não tem certeza do nome exato? Não se preocupe! O servidor suporta correspondência difusa para maior flexibilidade. 🔍

🚀 Começando

Pré-requisitos

Certifique-se de ter macOS com uma biblioteca de Fotos.
Instale uv para gerenciar dependências e executar o servidor.

Instalação

Clone o repositório:

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

Instale as dependências usando uv:
```
uv sync
```

Configure o servidor MCP. Atualize seu claude_desktop_config.json com a seguinte configuração:

{
  "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"
      ]
    }
  }
}

Inicie o servidor com o seguinte comando ou apenas abra o Claude Desktop:
```
uv run server.py
```

Nota: Substitua <YOUR_DEVICE_USERNAME> e <PATH_TO_CLONED_DIR> pelo seu nome de usuário real do dispositivo e o caminho para o diretório clonado. Você receberá um popup para autorizar o servidor a acessar suas fotos. Será apenas local, e nenhum dado será compartilhado com ninguém, exceto os serviços do Claude.

Inicialização do Servidor MCP

Quando o servidor iniciar, você verá:

Starting Smart Photo Journal MCP server.

Agora ele está pronto para processar suas consultas de fotos! 🎉

🛠️ Uso

Ferramentas Disponíveis

Busca por Localização
- Descrição: Encontre fotos tiradas em um local específico.
- Exemplo de Entrada:
```
{
  "location": "Udaipur"
}
```
- Saída Esperada:
```
Found 5 photos from Udaipur:
📷 IMG_1234.jpg
...
```
Busca por Rótulos
- Descrição: Pesquise fotos por rótulos ou palavras-chave.
- Exemplo de Entrada:
```
{
  "label": "Birthday"
}
```
- Saída Esperada:
```
Photos labeled as 'Birthday' (3 found):
📷 IMG_5678.jpg
...
```
Busca por Pessoas
- Descrição: Encontre fotos contendo pessoas específicas.
- Exemplo de Entrada:
```
{
  "person": "Maa"
}
```
- Saída Esperada:
```
Photos with Maa (10 found):
📷 IMG_9101.jpg
...
```
Análise de Fotos
- Descrição: Analise padrões em sua biblioteca de fotos, como os horários ou dias mais comuns para sessões de fotos.
- Exemplo de Entrada:
```
{}
```
- Saída Esperada:
```
📸 Photo Taking Patterns:
Total Photos: 200
...
```

📚 Exemplos de Casos de Uso

1. Organizador de Álbuns de Família e Amigos

Quer reunir todos os seus momentos em família em um só lugar? Use a ferramenta people-search com nomes como "Pai" ou "Mãe" ou "Qualquer Amigo" para encontrar fotos com pessoas específicas.

2. Destaques das Férias

Pesquise fotos do seu destino de férias usando a ferramenta location-search.

3. Diversão Nostálgica

Curioso sobre suas fotos de aniversário passadas? Use label-search com "Aniversário" e reviva a diversão!

4. Entenda Seus Hábitos Fotográficos

Use a ferramenta photo-analysis para entender quando e onde você tira a maioria das suas fotos. Planeje sua próxima sessão de acordo!

⚡ Dicas para Melhores Resultados

Certifique-se de que sua biblioteca de Fotos esteja carregada no macOS.
Seja o mais específico possível nas consultas de pesquisa para obter resultados mais precisos.
Use correspondência difusa para flexibilidade quando não tiver certeza do nome exato.