convez.ai
MCP ServerIntegração & APIsIntermediário
liheng-personal

Photos MCP Server

liheng-personal/photos-mcp-server

Acesse a biblioteca de Fotos do macOS via Claude e LLMs

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que expõe a biblioteca de Fotos do macOS para clientes LLM via Model Context Protocol. Oferece acesso a álbuns, busca, metadados e exportação de fotos através de AppleScript hardcoded, sem acesso a shell scripts.

Instalação

$npx convez-ai liheng-personal/photos-mcp-server

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Consultar e buscar fotos na biblioteca do macOS por palavras-chave
  • Recuperar metadados detalhados de fotos (data, localização, tags, descrição)
  • Exportar fotos para disco ou abri-las no app Fotos

Veredito

Ferramenta específica e bem-pensada para integração segura com o app Fotos do macOS. Implementação limpa com AppleScript hardcoded elimina riscos de injeção. Útil para fluxos que envolvem processamento inteligente de bibliotecas de mídia pessoal.

README

A tradução para o português deste README ainda está na fila.

photos-mcp-server

Per-app MCP server for macOS Photos. Exposes Photos library operations to LLM clients via the Model Context Protocol, using hardcoded AppleScript only — no shell script access.

Tools

ToolDescription
photos_list_albumsList all albums with item counts
photos_get_album_photosList photos/videos in an album (id, filename, date)
photos_search_photosSearch library by keyword
photos_get_photo_infoGet metadata for a single photo (filename, date, title, description, keywords, location)
photos_export_photoExport a photo to a folder on disk
photos_open_photoOpen and spotlight a photo in Photos app

Requirements

  • macOS (Photos app)
  • Node.js ≥ 18
  • Photos library access granted to Terminal / your MCP client

Setup

git clone https://github.com/liheng-personal/photos-mcp-server
cd photos-mcp-server
npm install
npm run build

Claude Desktop config

{
  "mcpServers": {
    "photos": {
      "command": "node",
      "args": ["/path/to/photos-mcp-server/dist/index.js"]
    }
  }
}

Security

All AppleScript is hardcoded in the source. No user-supplied content is passed to osascript. do shell script is never used.

Ver o original no GitHub

Bom para

Relacionados