mcp-osascript

Deja que Claude controle tu Mac. Mueve ventanas, haz clic en menús, escribe texto, lee el portapapeles, gestiona pestañas del navegador, toma capturas de pantalla, ejecuta Atajos — 18 herramientas tipadas con validación de entrada y salvaguardas de seguridad.

Listado en el Registro oficial de MCP como io.github.m0rvayne/mcp-osascript

Inicio rápido

Claude Desktop — un clic. Descarga mcp-osascript-1.1.3.mcpb desde la última versión y haz doble clic. Claude Desktop instala la extensión por sí mismo.

O agrégalo a la configuración manualmente:

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

Añade esto a tu configuración de Claude Desktop (Settings → Developer → Edit Config), reinicia Claude y estarás listo.

{
  "mcpServers": {
    "osascript": {
      "command": "npx",
      "args": ["-y", "mcp-osascript"]
    }
  }
}

claude mcp add osascript -- npx -y mcp-osascript

git clone https://github.com/m0rvayne/mcp-osascript.git
cd mcp-osascript && npm install
# then use: "command": "node", "args": ["/path/to/mcp-osascript/server/index.js"]

Prueba estos comandos

Una vez instalado, pídele a Claude:

Herramientas

18 herramientas tipadas, cada una con validación de entrada, clasificación de errores y mensajes de error conscientes de permisos.

Menús autocorrectivos

Cuando Claude intenta hacer clic en un elemento de menú que no existe, el servidor devuelve automáticamente la lista de elementos disponibles en ese nivel — para que Claude pueda reintentar con el nombre correcto. Ningún otro servidor MCP hace esto.

User:   "Click File → Export as PDF in Preview"
Claude: calls app_menu click ["File", "Export as PDF"]
Server: "Menu item 'Export as PDF' not found in 'File'.
         Available: ['New from Clipboard', 'Open...', 'Close', 'Save',
         'Duplicate', 'Rename...', 'Export...', 'Export as PDF...']"
Claude: calls app_menu click ["File", "Export as PDF..."]
Server: "Clicked: File > Export as PDF..."

¿Por qué mcp-osascript?

Los conteos de estrellas son una medida de popularidad, no de calidad — ambas alternativas preceden a este proyecto por meses. Las filas anteriores son las cosas que difieren en la práctica.

Auditorías de seguridad

Cuatro pases de auditoría de equipo rojo (agentes adversariales ejecutados contra el código fuente, encargados por el autor — no una certificación de terceros), la más reciente contra v1.1.2 con tres agentes paralelos que cubren la superficie de shell, el escape de AppleScript y la divulgación de información. Encontró seis defectos reales, incluida una herramienta que anulaba silenciosamente la lista blanca de esquemas de otra herramienta y una ranura de concurrencia que podía filtrarse hasta que el servidor se bloqueaba. Cada hallazgo está corregido y lleva una prueba de regresión. escapeAS fue verificado contra 13 candidatos de ruptura de cadenas a través de osascript real — ninguno escapa.

Permisos

Las herramientas funcionan en tres niveles:

• Sin permiso necesario — portapapeles, notificaciones, URLs, aplicaciones, archivos, pantallas, Atajos. Funciona de inmediato.
• Automatización — pestañas del navegador, aplicación en primer plano. macOS solicita una vez por navegador.
• Accesibilidad — teclado, ventanas, menús, ocultar/mostrar. Concede una vez en Configuración del Sistema → Privacidad y Seguridad → Accesibilidad.
• Grabación de pantalla — solo capturas de pantalla. Concede en Configuración del Sistema → Privacidad y Seguridad → Grabación de pantalla.

Pídele a Claude que ejecute check_permissions y te dirá cuáles de estos ya están concedidos, qué herramientas desbloquea cada uno y exactamente qué panel de configuración abrir para el resto. Las sondas son de solo lectura y nunca activan una solicitud de permiso.

Cuando falta un permiso, el servidor te dice exactamente qué hacer:

"Accessibility permission required. Grant access to 'osascript'
in System Settings > Privacy & Security > Accessibility."

Pruebas

npm test

84 pruebas de integración que cubren las 18 herramientas — validación de entrada, límites de seguridad (bloqueo de esquemas de URL, contaminación de prototipos, límites de tamaño de script), aplicación de tiempos de espera, manejo de errores de permisos y regresiones para cada hallazgo de la auditoría de seguridad.

Requisitos

• macOS 13+ (Ventura o posterior)
• Node.js 18+

Licencia

MIT