Servidor MCP de AppleScript

Integra IA con macOS usando el Servidor MCP de AppleScript para una potente automatización y control programático de aplicaciones y funciones del sistema en Mac.

Servidor MCP de AppleScript

¿Qué hace el Servidor MCP “AppleScript”?

El Servidor MCP de AppleScript es un servidor Model Context Protocol (MCP) diseñado para proporcionar a asistentes de IA y herramientas de desarrollo la capacidad de ejecutar código AppleScript en un Mac. Actuando como un puente, permite que agentes de IA accedan y controlen aplicaciones y funciones del sistema en Mac, como interactuar con Notas, Calendario, Contactos, Mensajes y mucho más. El servidor admite tareas como buscar archivos mediante Spotlight, leer y escribir archivos, ejecutar comandos de terminal e incluso ejecución remota vía SSH. Su diseño ligero e intuitivo facilita su integración, mejorando significativamente la automatización, la productividad y el flujo de trabajo de los usuarios de Mac, al permitir acceso programático a una amplia gama de funciones de macOS.

Lista de Prompts

No se documentan plantillas de prompts reutilizables en el repositorio. Solo se proporcionan ejemplos de prompts para el usuario final.

Lista de Recursos

No se describen recursos MCP explícitos en la documentación o el código disponible.

Lista de Herramientas

No se proporciona un listado detallado de herramientas en server.js o la documentación. El servidor permite la ejecución arbitraria de AppleScript, pero no se enumeran primitivas específicas de herramientas.

Casos de uso de este Servidor MCP

  • Automatización de aplicaciones Mac: Permite a desarrolladores y agentes de IA automatizar flujos de trabajo que involucran Notas, Calendario, Contactos, Mensajes y otras apps de macOS mediante comandos AppleScript.
  • Gestión de archivos y sistema: Facilita la búsqueda de archivos usando Spotlight o Finder, la lectura y escritura de contenidos de archivos y la gestión programática de carpetas y documentos.
  • Obtención de información del sistema: Permite consultar el estado del sistema como porcentaje de batería, espacio en disco y aplicaciones en ejecución, útil tanto para usuarios como para agentes automatizados.
  • Ejecución remota: Admite la ejecución de AppleScript de forma remota vía SSH, haciendo posible gestionar un Mac desde otra máquina o contenedor.
  • Control multimedia y de comunicaciones: Ofrece control sobre la reproducción multimedia (por ejemplo, en Apple Music) y puede interactuar con aplicaciones de comunicación para automatizar emails, mensajes o recordatorios.

Cómo configurarlo

Windsurf

  1. Asegúrate de que Node.js esté instalado en tu sistema.
  2. Abre el archivo de configuración de Windsurf.
  3. Añade el Servidor MCP de AppleScript a tu sección mcpServers usando el siguiente fragmento JSON.
  4. Guarda la configuración y reinicia Windsurf.
  5. Verifica que el servidor esté corriendo y sea accesible.
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude

  1. Asegúrate de que Node.js esté instalado.
  2. Localiza y abre el archivo de configuración de Claude.
  3. Añade el servidor MCP como se muestra en el ejemplo a continuación.
  4. Guarda la configuración y reinicia Claude.
  5. Confirma que el servidor MCP está disponible para su uso.
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor

  1. Instala Node.js en tu sistema.
  2. Abre el archivo de configuración de Cursor.
  3. Inserta la entrada del servidor MCP de AppleScript en la sección mcpServers.
  4. Guarda y reinicia Cursor.
  5. Comprueba que la integración haya sido exitosa.
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline

  1. Verifica que Node.js esté instalado.
  2. Edita el archivo de configuración de Cline.
  3. Añade la configuración del servidor MCP según el ejemplo siguiente.
  4. Guarda los cambios y reinicia Cline.
  5. Prueba para asegurarte de que el servidor MCP esté operativo.
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}

Cómo proteger claves API y credenciales

Para ejecución remota, la información sensible como nombres de usuario y contraseñas SSH puede proporcionarse mediante variables de entorno para mayor seguridad. Ejemplo:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ],
      "env": {
        "REMOTE_USER": "tunombreusuario",
        "REMOTE_PASSWORD": "tucontraseña"
      },
      "inputs": {
        "remoteHost": "host.docker.internal"
      }
    }
  }
}

Cómo usar este MCP dentro de flujos

Uso de MCP en FlowHunt

Para integrar servidores MCP en tu flujo de trabajo de FlowHunt, comienza añadiendo el componente MCP a tu flujo y conectándolo con tu agente de IA:

Flujo MCP de FlowHunt

Haz clic en el componente MCP para abrir el panel de configuración. En la sección de configuración del sistema MCP, inserta los detalles de tu servidor MCP usando este formato JSON:

{
  "applescript_execute": {
    "transport": "streamable_http",
    "url": "https://tuservidormcp.ejemplo/pathtothemcp/url"
  }
}

Una vez configurado, el agente de IA podrá utilizar este MCP como herramienta con acceso a todas sus funciones y capacidades. Recuerda cambiar “applescript_execute” por el nombre real de tu servidor MCP y reemplazar la URL por la de tu propio servidor MCP.


Resumen

SecciónDisponibilidadDetalles/Notas
ResumenProporciona un resumen del Servidor MCP de AppleScript
Lista de PromptsNo hay plantillas reutilizables; solo ejemplos de usuario final
Lista de RecursosNo se listan recursos MCP explícitos
Lista de HerramientasNo se enumeran primitivas detalladas; soporta ejecución de AppleScript
Protección de claves APISe da ejemplo con variables de entorno
Soporte de muestreo (menos relevante aquí)No se menciona soporte de muestreo

Según las tablas anteriores, el Servidor MCP de AppleScript ofrece una integración sencilla pero limitada. Su fortaleza está en el control directo del Mac mediante AppleScript. Sin embargo, carece de plantillas de prompts documentadas, recursos MCP explícitos y primitivas detalladas de herramientas. La presencia de una licencia, popularidad moderada e instrucciones de configuración claras son puntos positivos. En general, es muy útil para su nicho, aunque la documentación podría ser más profunda.


Puntuación MCP

Tiene LICENSE✅ (MIT)
Tiene al menos una herramienta✅ (Ejecución de AppleScript)
Número de forks32
Número de estrellas270

Preguntas frecuentes

¿Qué es el Servidor MCP de AppleScript?

El Servidor MCP de AppleScript es un servidor Model Context Protocol que permite a agentes de IA y herramientas de automatización ejecutar AppleScript en macOS, habilitando el control sobre aplicaciones, archivos, configuraciones del sistema y ejecución remota.

¿Cuáles son los principales casos de uso?

Los casos de uso incluyen automatización de aplicaciones Mac, gestión de archivos y sistema, obtención de información del sistema, ejecución remota de AppleScript vía SSH y control sobre aplicaciones de comunicación y multimedia.

¿Cómo agrego el Servidor MCP de AppleScript a FlowHunt o mi herramienta de desarrollo?

Añade la configuración del servidor en la sección mcpServers de tu herramienta como se muestra en la guía de configuración. Asegúrate de tener Node.js instalado y sigue los pasos de configuración JSON para tu cliente.

¿Se admite la ejecución remota?

Sí, el servidor permite la ejecución remota de AppleScript a través de SSH. Utiliza variables de entorno para proporcionar credenciales SSH de forma segura.

¿Cuáles son los límites o características faltantes?

El servidor carece de plantillas de prompts documentadas y no proporciona recursos MCP explícitos ni primitivas detalladas de herramientas. Su fortaleza reside en la automatización directa de Mac e integración con flujos de IA.

Potencia al máximo la automatización de tu Mac con el Servidor MCP de AppleScript

Activa flujos de trabajo impulsados por IA, automatiza tareas de macOS y controla tu Mac de forma remota usando la integración fluida del Servidor MCP de AppleScript de FlowHunt.

Saber más