Photos MCP Server
liheng-personal/photos-mcp-server
Acesse a biblioteca de Fotos do macOS via Claude e LLMs
Ver no GitHubServidor 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-server1 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
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
| Tool | Description |
|---|---|
photos_list_albums | List all albums with item counts |
photos_get_album_photos | List photos/videos in an album (id, filename, date) |
photos_search_photos | Search library by keyword |
photos_get_photo_info | Get metadata for a single photo (filename, date, title, description, keywords, location) |
photos_export_photo | Export a photo to a folder on disk |
photos_open_photo | Open 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.