Controle do macOS — Automação de Mac com IA
Dê ao Claude controle direto do seu Mac através de 15 ferramentas MCP. Abra apps, alterne modo escuro, pesquise arquivos, tire capturas de tela, gerencie a área de transferência — tudo via linguagem natural.
Localização
Projeto: /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/
Servidor MCP: Mac-Automation/macos_mcp.py
Referência de Ferramentas
Sistema (somente leitura)
get_system_info() # Versão do macOS, chip, RAM, tempo de atividade
get_running_apps() # Todos os apps visíveis em execução
get_disk_usage() # Armazenamento por volume
Controle de Apps
open_app(app_name="Safari") # Iniciar app (validado em /Applications/)
close_app(app_name="Notes") # Sair suavemente via AppleScript
switch_to_app(app_name="Terminal") # Trazer para o primeiro plano
Display e Áudio
toggle_dark_mode() # Alternar claro <-> escuro (visual instantâneo)
set_volume(level=50) # 0-100, ativa o som automaticamente
Notificações
send_notification(title="Ei", message="Aula começando!", sound="Glass")
play_sound(sound_name="Ping") # 14 sons do sistema disponíveis
Arquivos e Pesquisa
spotlight_search(query="fatura.pdf", folder="~/Documents", limit=20)
open_folder(folder_path="~/Desktop") # Abre no Finder
Área de Transferência
get_clipboard() # Ler área de transferência atual
set_clipboard(text="Olá Mundo") # Escrever na área de transferência
Captura de Tela
take_screenshot(region="full") # Salva PNG na Área de Trabalho
take_screenshot(region="window") # Apenas a janela frontal
Esquema
Entradas
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| app_name | str | varia | Nome do app sem .app (ex.: 'Safari') |
| level | int | varia | Volume 0-100 |
| title | str | varia | Título da notificação |
| message | str | varia | Corpo da notificação |
| sound | str | não | Nome do som (default/Glass/Ping/Pop/etc.) |
| query | str | varia | Consulta de pesquisa Spotlight |
| folder | str | não | Pasta para restringir a pesquisa |
| text | str | varia | Texto para a área de transferência |
| region | str | não | Região da captura de tela (full/window) |
Saídas
| Nome | Tipo | Descrição |
|---|---|---|
| result | str | Resultado legível ou mensagem de erro |
Credenciais
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| (nenhum) | — | — | Nenhuma credencial necessária — usa comandos locais do macOS |
Composável com
ghost-browser— captura de tela → analisar → automatizar navegadorgoogle-mcp— pesquisar arquivos → anexar emailinstantly-campaigns— área de transferência → templates de email
Custo
Grátis — apenas stdlib, sem chamadas de API.
Segurança
- Palavras-chave bloqueadas: rm, sudo, shutdown, format, erase, passwd, kill
- Nomes de apps validados em /Applications/
- Strings AppleScript sanitizadas
- Timeout de 10s em todos os comandos
- Nenhum shell=True em lugar algum