OuEstCharlie Woof — MCP App photo gallery

Pesquise e navegue suas fotos no seu assistente de IA, preservando sua privacidade e metadados.

Documentação

Woof

Woof — Veja sua Galeria de Fotos no seu assistente de IA

mcp-name: io.github.ouestcharlie/ouestcharlie-woof

Woof é o companheiro de galeria de fotos e vídeos para o seu assistente de IA (Claude Desktop, Goose, VS Code / GitHub Copilot...). Ele complementa essas ferramentas poderosas com uma galeria pesquisável. Suas fotos e vídeos permanecem exatamente onde estão — em seus próprios discos (locais ou montados).

Sem assinatura de nuvem. Sem bloqueio proprietário. Sua biblioteca, do seu jeito.

Woof é o frontend MCP App para "Où est Charlie ?" ("Onde está Wally?" em francês), um framework nativo de IA completo para gerenciar suas fotos e vídeos.

O que o torna diferente

A maioria dos gerenciadores de fotos bloqueia sua biblioteca em um serviço de nuvem (Google Photos, iCloud) ou exige um servidor de banco de dados que se torna um ponto único de falha. Woof adota uma abordagem diferente:

Conversa como sua galeria. Woof conecta-se ao seu assistente de IA (Claude Desktop, ChatGPT, Goose, VS Code / GitHub Copilot…) e o transforma em um navegador de fotos completo. Pergunte em linguagem natural, obtenha resultados inline. Nenhum aplicativo separado para aprender.
Privacidade por design. Apenas metadados viajam para o seu assistente de IA — suas fotos reais são servidas localmente pelo Woof. Suas imagens nunca são enviadas a nenhum serviço de IA, a menos que você peça explicitamente.
Sem bloqueio de banco de dados. Os metadados vivem como arquivos sidecar XMP ao lado de suas fotos, além de manifestos JSON leves. Mova um disco, copie uma pasta — toda a sua organização viaja com suas fotos.
Formatos abertos, para sempre. XMP é um padrão ISO. JSON é universal. AVIF é livre de royalties. Cada ferramenta que você já usa — Lightroom, darktable, ExifTool — pode ler seus metadados hoje e muito depois que OuEstCharlie desaparecer.
Suas fotos nunca são tocadas. Woof lê sua biblioteca como está. Ele nunca modifica, move ou exclui seus arquivos originais. Ele também respeita metadados XMP existentes do Lightroom, darktable ou qualquer outra ferramenta — em vez de sobrescrevê-los.
Funciona com sua estrutura de pastas existente. Basta apontar o Woof para sua pasta de fotos. Sem migração, sem reorganização necessária.

Mais sobre OuEstCharlie e Woof no Blog OuEstCharlie

Instalação

Woof roda como um servidor MCP local. Ele conecta-se ao seu cliente de IA desktop (Claude Desktop, Goose...) e expõe sua biblioteca de fotos como um conjunto de ferramentas.

Opção A — Instalação em pacote (recomendada, mas apenas Claude Desktop)

Conectar ao Claude Desktop

Baixe o ouestcharlie-woof.mcpb mais recente da página de Releases e clique duas vezes nele. O Claude Desktop solicitará que você instale o Woof com um clique — sem necessidade de editar arquivos de configuração.

Veja também no Blog Woof:

Instalação passo a passo do OuEstCharlie Woof no Claude Desktop

Opção B — Configuração manual do `uvx`

Pré-requisitos

Os pacotes Python do OuEstCharlie Woof são gerenciados por uv e pelo comando uvx. O uv pode já estar disponível no seu sistema.

Pré-requisitos do sistema (todas as opções de instalação):

macOS: brew install inih brotli gettext (exigido pelo pyexiv2 em tempo de execução)
Linux/Windows: nenhum passo extra

Conectar ao Claude Desktop

Referência: Começando com Servidores MCP Locais no Claude Desktop

Abra (ou crie) ~/Library/Application Support/Claude/claude_desktop_config.json e adicione ou atualize mcpServers:

{
  "mcpServers": {
    "woof": {
      "command": "uvx",
      "args": ["--python", "3.13", "--from", "ouestcharlie-woof", "woof-bridge"]
    }
  }
}

Reinicie o Claude Desktop. O Woof aparecerá como uma integração MCP, e a galeria será renderizada como um painel interativo dentro da sua conversa.

Conectar ao ChatGPT Desktop

NOTA: A partir de maio de 2026, o ChatGPT não suporta mais servidores MCP locais. O seguinte não está mais disponível!

Conectar ao Goose

Referência: Documentação de extensões MCP do Goose

O Goose suporta servidores MCP via seu sistema de extensões.

Adicione pela interface do usuário como uma Extensão Personalizada:

Setup Woof extension in Goose

Configurar extensão Woof no Goose

Ou adicione o seguinte à sua configuração do Goose (~/.config/goose/config.yaml):

extensions:
  woof:
    type: stdio
    cmd: uvx
    args: ["--python", "3.13", "--from", "ouestcharlie-woof", "woof-bridge"]
    enabled: true

Adicionar ao VS Code (harness GitHub Copilot)

Para instalar no VS Code:

Na Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P), selecione "MCP: Add Server..."
O mais simples é usar a opção de instalação "Pip Package"
- Digite o nome do pacote Woof: "ouestcharlie-woof"
- Aceite para confirmar
- O ponto de entrada é woof-bridge (não woof, como proposto pelo prompt)

A configuração composta deve ser:

{
	"servers": {
		"woof-bridge": {
			"command": "uvx",
			"args": [
				"--python",
				"3.13",
				"--from",
				"ouestcharlie-woof",
				"woof-bridge"
			],
			"type": "stdio"
		}
	},
	"inputs": []
}

Verifique se o woof-bridge está ativado através de "MCP: List Servers" na Paleta de Comandos.

Outros assistentes de IA suportados

Outros clientes suportam MCP Apps, por exemplo Codex.

Veja a Matriz de Suporte a Extensões MCP

Plugin de habilidades opcional

Woof fornece habilidades opcionais com fluxos de trabalho, veja a seção Tutorial abaixo. Para instalar o plugin contendo as habilidades, referencie este repositório como ouestcharlie/ouestcharlie-woof:

Claude Desktop, em Configurações > "Plugins" > "Adicionar" no canto superior direito > "Adicionar um marketplace" > "Adicionar de um repositório"
VSCode, na Paleta de Comandos > "Chat: Instalar Plugin da Fonte"

Primeiros Passos

1. Registre sua pasta de fotos

Uma vez que o Woof esteja conectado ao seu cliente de IA, peça para registrar sua pasta de fotos:

"Adicione uma biblioteca local ao Woof apontando para /Users/yourname/Pictures"

Woof suporta qualquer pasta em um disco local — incluindo pastas sincronizadas do iCloud Drive, OneDrive ou Google Drive, desde que os arquivos estejam disponíveis localmente.

2. Indexe sua biblioteca

Acione o indexador para escanear suas fotos e construir o índice de metadados:

"Indexe minha biblioteca local"

Woof lançará o agente de indexação, que irá:

Ler metadados EXIF/XMP de cada foto
Escrever arquivos sidecar XMP ao lado de seus originais (nunca modificando os originais)
Gerar miniaturas e pré-visualizações
Construir um índice rápido para consultas

A velocidade de indexação é de aproximadamente 10 a 100 segundos por 1.000 fotos, dependendo do formato e hardware.

3. Comece a navegar

Uma vez que a indexação esteja completa, basta perguntar:

"Mostre-me fotos no Woof de julho passado"

"No Woof, mostre-me fotos tiradas perto de Paris"

"Pesquise no Woof por fotos com 'Tour Eiffel' na descrição"

"Quantas fotos eu tenho no Woof?"

O painel da galeria aparecerá inline na sua conversa com os resultados correspondentes.

Woof in Claude Desktop

Galeria de fotos Ouestcharlie Woof dentro do Claude Desktop

Mais tutoriais

Armazenamento

Woof suporta bibliotecas filesystem e cloud_mount no macOS, Linux e Windows:

filesystem para um disco rígido local padrão ou SSD, incluindo unidade de rede local (ex.: NAS)
cloud_mount para uma pasta sincronizada do iCloud Drive, OneDrive, Google Drive ou Infomaniak kDrive — desde que os arquivos estejam baixados e acessíveis localmente

Armazenamento nativo em nuvem (S3, Azure, GCS, API OneDrive) está planejado.

Status

Woof é uma pré-visualização inicial. Funciona bem hoje para navegar e pesquisar uma biblioteca de fotos local.

Recursos atuais

Recurso	Notas
Compatível com Claude Desktop, Goose, VS Code	Qualquer aplicativo desktop com suporte a MCP App
Disponível no macOS, Windows, Linux	Pacotes Python são construídos e lançados no PyPI
Indexação de filesystem local	Arquivos devem estar sincronizados localmente
Fotos (JPEG, PNG, TIFF, HEIC, RAW)	HEIC e RAW dependem das opções de build
Suporte a vídeo (MOV, MP4)
Visualização da galeria como grade ou pré-visualização	Detalhes da foto na pré-visualização
Miniaturas e pré-visualizações de imagem	Otimizadas para exibição
Pesquisa por descrição, tags, classificação, data, partição	Pesquisa de texto completo na descrição
Pesquisa por recursos de foto (data, dimensões, caixa delimitadora GPS)
Pesquisa por recursos de vídeo (duração, dimensões, caixa delimitadora GPS)
Pesquisa por recursos de câmera (marca, modelo, abertura, lente)
Classificação ascendente ou descendente em qualquer campo
Detecção de mudanças / re-indexação automática	Parcial — fotos adicionadas e removidas

Recursos planejados

Recurso
Álbuns e filtros inteligentes
Compartilhar fotos com o host (Claude Desktop, ChatGPT, Goose…)
Agentes de enriquecimento (rostos, reconhecimento de cena)
Aplicativo companheiro móvel
Bibliotecas nativas em nuvem (S3, OneDrive, GCS…)

Se você encontrar um bug ou comportamento inesperado, por favor abra um issue.

Woof in VSCode

Galeria de fotos Ouestcharlie Woof dentro do VSCode, uma alternativa ao Claude CoWork para técnicos

Política de Privacidade

Woof é projetado com a privacidade como princípio central.

Dados coletados: Apenas metadados de fotos (EXIF, coordenadas GPS, marca/modelo da câmera, datas, caminhos de arquivo) são lidos e indexados. Nenhuma conta ou informação pessoal é coletada.
Armazenamento de dados: Todos os metadados são armazenados localmente no seu próprio dispositivo como arquivos sidecar XMP e manifestos JSON ao lado de suas fotos. Nenhum dado é armazenado em servidor remoto.
Assistente de IA: Apenas metadados e imagens em miniatura são enviados ao seu assistente de IA (Claude, ChatGPT, Goose…) quando você realiza uma pesquisa. Seus arquivos de foto originais nunca são enviados a nenhum serviço de IA, a menos que você os compartilhe explicitamente.
Terceiros: Nenhum metadado ou dado de uso é compartilhado com terceiros.
Retenção: Todos os dados permanecem sob seu controle total. Excluir os sidecars XMP e as pastas .ouestcharlie/ da sua biblioteca de fotos remove completamente todos os metadados do Woof.

Para perguntas sobre privacidade, por favor abra um issue.

Suporte

Relatórios de bugs e solicitações de recursos: GitHub Issues

Canto dos desenvolvedores

Para documentação de desenvolvedor e arquitetura, veja README_DEV.md.

Contribuindo

Veja a seção Contribuindo no OuEstCharlie

Licença

Licença MIT

OuEstCharlie Woof — MCP App photo gallery

Documentação

Woof — Veja sua Galeria de Fotos no seu assistente de IA

O que o torna diferente

Instalação

Opção A — Instalação em pacote (recomendada, mas apenas Claude Desktop)

Conectar ao Claude Desktop

Veja também no Blog Woof:

Opção B — Configuração manual do uvx

Pré-requisitos

Conectar ao Claude Desktop

Conectar ao ChatGPT Desktop

Conectar ao Goose

Adicionar ao VS Code (harness GitHub Copilot)

Outros assistentes de IA suportados

Plugin de habilidades opcional

Primeiros Passos

1. Registre sua pasta de fotos

2. Indexe sua biblioteca

3. Comece a navegar

Mais tutoriais

Armazenamento

Status

Recursos atuais

Recursos planejados

Política de Privacidade

Suporte

Canto dos desenvolvedores

Contribuindo

Licença

Opção B — Configuração manual do `uvx`