AppleScript MCP

Servidor MCP de AppleScript (Acceso dual: python y node.js)

Resumen

Un servidor de Protocolo de Contexto de Modelo (MCP) que te permite ejecutar código AppleScript para interactuar con Mac. Este MCP está diseñado intencionalmente para ser simple, directo, intuitivo y requerir una configuración mínima.

No puedo creer lo simple y poderoso que es. El código central tiene menos de 100 líneas de código.

https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388

Características

• Ejecuta AppleScript para acceder a aplicaciones y datos de Mac
• Interactúa con Notas, Calendario, Contactos, Mensajes y más
• Busca archivos usando Spotlight o Finder
• Lee/escribe contenido de archivos y ejecuta comandos de shell
• Soporte de ejecución remota vía SSH

Ejemplos de Prompts

Create a reminder for me to call John tomorrow at 10am

Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"

Create a new note titled "Meeting Minutes" with today's date

Show me all files in my Downloads folder from the past week

What's my current battery percentage?

Show me the most recent unread emails in my inbox

List all the currently running applications on my Mac

Play my "Focus" playlist in Apple Music

Take a screenshot of my entire screen and save it to my Desktop

Find John Smith in my contacts and show me his phone number

Create a folder on my Desktop named "Project Files"

Open Safari and navigate to apple.com

Tell me how much free space I have on my main drive

List all my upcoming calendar events for this week

Uso con Claude Desktop

Node.js

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Python (uvx)

No se necesita clonar — ejecuta directamente desde el repositorio git:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peakmojo/applescript-mcp",
        "mcp-server-applescript"
      ]
    }
  }
}

Python (desarrollo local)

Para desarrollo local, clona el repositorio y usa uv para ejecutar desde el código fuente:

brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "mcp-server-applescript"
      ]
    }
  }
}

Desarrollo

Configuración

brew install uv
uv sync --dev

Ejecutar todas las verificaciones (en paralelo)

uv run check

Esto ejecuta linting, formato, verificación de tipos y pruebas con 100% de cobertura — todo en paralelo.

Comandos individuales

uv run lint        # ruff linter
uv run format      # ruff auto-format
uv run typecheck   # pyrefly type checker
uv run test        # pytest with 100% coverage enforcement

Uso con Docker

Cuando se ejecuta en un contenedor Docker, puedes usar el nombre de host especial host.docker.internal para conectarte a tu Mac anfitrión:

Configuración

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp",
        "--remoteHost", "host.docker.internal",
        "--remoteUser", "yourusername",
        "--remotePassword", "yourpassword"
      ]
    }
  }
}

Esto permite que tu contenedor Docker ejecute AppleScript en el sistema Mac anfitrión. Asegúrate de:

1. SSH esté habilitado en tu Mac (Configuración del Sistema → Compartir → Inicio de sesión remoto)
2. Tu usuario tenga los permisos adecuados
3. Las credenciales correctas se proporcionen en la configuración