Control macOS — Automatización de Mac con IA
Dale a Claude el control directo de tu Mac mediante 15 herramientas MCP. Abre aplicaciones, alterna el modo oscuro, busca archivos, toma capturas de pantalla, gestiona el portapapeles — todo a través de lenguaje natural.
Ubicación
Proyecto: /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/
Servidor MCP: Mac-Automation/macos_mcp.py
Referencia de Herramientas
Sistema (solo lectura)
get_system_info() # Versión de macOS, chip, RAM, tiempo de actividad
get_running_apps() # Todas las aplicaciones visibles en ejecución
get_disk_usage() # Almacenamiento por volumen
Control de Aplicaciones
open_app(app_name="Safari") # Iniciar aplicación (validada contra /Applications/)
close_app(app_name="Notes") # Cierre elegante mediante AppleScript
switch_to_app(app_name="Terminal") # Traer al frente
Pantalla y Audio
toggle_dark_mode() # Alternar claro <-> oscuro (visual instantáneo)
set_volume(level=50) # 0-100, reactiva el audio automáticamente
Notificaciones
send_notification(title="Oye", message="¡Clase comenzando!", sound="Glass")
play_sound(sound_name="Ping") # 14 sonidos del sistema disponibles
Archivos y Búsqueda
spotlight_search(query="factura.pdf", folder="~/Documentos", limit=20)
open_folder(folder_path="~/Escritorio") # Abre en Finder
Portapapeles
get_clipboard() # Leer el portapapeles actual
set_clipboard(text="Hola Mundo") # Escribir en el portapapeles
Captura de Pantalla
take_screenshot(region="full") # Guarda PNG en el Escritorio
take_screenshot(region="window") # Solo la ventana activa
Esquema
Entradas
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| app_name | str | varía | Nombre de la aplicación sin .app (ej., 'Safari') |
| level | int | varía | Volumen 0-100 |
| title | str | varía | Título de la notificación |
| message | str | varía | Cuerpo de la notificación |
| sound | str | no | Nombre del sonido (default/Glass/Ping/Pop/etc.) |
| query | str | varía | Consulta de búsqueda en Spotlight |
| folder | str | no | Carpeta para acotar la búsqueda |
| text | str | varía | Texto para el portapapeles |
| region | str | no | Región de la captura (full/window) |
Salidas
| Nombre | Tipo | Descripción |
|---|---|---|
| result | str | Resultado legible o mensaje de error |
Credenciales
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| (ninguna) | — | — | No necesita credenciales — usa comandos locales de macOS |
Componible Con
ghost-browser— captura de pantalla → analizar → automatizar navegadorgoogle-mcp— buscar archivos → adjuntar a correoinstantly-campaigns— portapapeles → plantillas de correo
Coste
Gratuito — solo stdlib, sin llamadas API.
Seguridad
- Palabras clave bloqueadas: rm, sudo, shutdown, format, erase, passwd, kill
- Nombres de aplicaciones validados contra /Applications/
- Strings de AppleScript sanitizadas
- Tiempo de espera de 10 segundos en todos los comandos
- No se usa shell=True en ninguna parte