applescript-mcp

Servidor MCP applescript-mcp

Un servidor de Protocolo de Contexto de Modelo que permite que las aplicaciones LLM interactúen con macOS mediante AppleScript. Este servidor proporciona una interfaz estandarizada para que las aplicaciones de IA controlen las funciones del sistema, administren archivos, gestionen notificaciones y más.

Características

🗓️ Gestión de calendario (eventos, recordatorios)
Operaciones del portapapeles
🔍 Integración con Finder
🔔 Notificaciones del sistema
⚙️ Controles del sistema (volumen, modo oscuro, aplicaciones)
Integración del terminal iTerm
📬 Correo (crear nuevo correo electrónico, listar correos electrónicos, recibir correo electrónico)
🔄 Automatización de atajos
💬 Mensajes (listar chats, recibir mensajes, buscar mensajes, enviar un mensaje)
🗒️ Notas (crear notas formateadas, enumerar notas, buscar notas)
📄 Páginas (crear documentos)

Funciones planificadas

🧭 Safari (abrir en Safari, guardar el contenido de la página, obtener la página/pestaña seleccionada)
✅ Recordatorios (crear, recibir)

Prerrequisitos

macOS 10.15 o posterior
Node.js 18 o posterior

Categorías disponibles

Calendario

Dominio	Descripción	Parámetros
`add`	Crear evento de calendario	`title` , `startDate` , `endDate` , `calendar` (opcional)
`list`	Enumere los eventos de hoy	Ninguno

Ejemplos

// Create a new calendar event
Create a calendar event titled "Team Meeting" starting tomorrow at 2pm for 1 hour

// List today's events
What events do I have scheduled for today?

Portapapeles

Dominio	Descripción	Parámetros
`set_clipboard`	Copiar al portapapeles	`content`
`get_clipboard`	Obtener el contenido del portapapeles	Ninguno
`clear_clipboard`	Borrar el portapapeles	Ninguno

Ejemplos

// Copy text to clipboard
Copy "Remember to buy groceries" to my clipboard

// Get clipboard contents
What's currently in my clipboard?

// Clear clipboard
Clear my clipboard

Descubridor

Dominio	Descripción	Parámetros
`get_selected_files`	Obtener archivos seleccionados	Ninguno
`search_files`	Buscar archivos	`query` , `location` (opcional)
`quick_look`	Archivo de vista previa	`path`

Ejemplos

// Get selected files in Finder
What files do I currently have selected in Finder?

// Search for files
Find all PDF files in my Documents folder

// Preview a file
Show me a preview of ~/Documents/report.pdf

Notificaciones

Nota: Para enviar notificaciones es necesario habilitar las notificaciones en Configuración del sistema > Notificaciones > Editor de scripts.

Dominio	Descripción	Parámetros
`send_notification`	Mostrar notificación	`title` , `message` , `sound` (opcional)
`toggle_do_not_disturb`	Activar o desactivar el modo DND	Ninguno

Ejemplos

// Send a notification
Send me a notification with the title "Reminder" and message "Time to take a break"

// Toggle Do Not Disturb
Turn on Do Not Disturb mode

Sistema

Dominio	Descripción	Parámetros
`volume`	Establecer el volumen del sistema	`level` (0-100)
`get_frontmost_app`	Obtener aplicación activa	Ninguno
`launch_app`	Abrir solicitud	`name`
`quit_app`	Cerrar aplicación	`name` , `force` (opcional)
`toggle_dark_mode`	Activar el modo oscuro	Ninguno

Ejemplos

// Set system volume
Set my Mac's volume to 50%

// Get active application
What app am I currently using?

// Launch an application
Open Safari

// Quit an application
Close Spotify

// Toggle dark mode
Switch to dark mode

iTerm

Dominio	Descripción	Parámetros
`paste_clipboard`	Pegar en iTerm	Ninguno
`run`	Ejecutar comando	`command` , `newWindow` (opcional)

Ejemplos

// Paste clipboard to iTerm
Paste my clipboard contents into iTerm

// Run a command in iTerm
Run "ls -la" in iTerm

// Run a command in a new iTerm window
Run "top" in a new iTerm window

Atajos

Dominio	Descripción	Parámetros
`run_shortcut`	Ejecutar un atajo	`name` , `input` (opcional)
`list_shortcuts`	Listar todos los accesos directos disponibles	`limit` (opcional)

Ejemplos

// List available shortcuts
List all my available shortcuts

// List with limit
Show me my top 5 shortcuts

// Run a shortcut
Run my "Daily Note in Bear" shortcut

// Run a shortcut with input
Run my "Add to-do" shortcut with input "Buy groceries"

Correo

Dominio	Descripción	Parámetros
`create_email`	Crear un nuevo correo electrónico en Mail.app	`recipient` , `subject` , `body`
`list_emails`	Listar correos electrónicos de un buzón	`mailbox` (opcional), `count` (opcional), `unreadOnly` (opcional)
`get_email`	Obtenga un correo electrónico específico mediante una búsqueda	`subject` (opcional), `sender` (opcional), `dateReceived` (opcional), `mailbox` (opcional), `account` (opcional), `unreadOnly` (opcional), `includeBody` (opcional)

Ejemplos

// Create a new email
Compose an email to john@example.com with subject "Meeting Tomorrow" and body "Hi John, Can we meet tomorrow at 2pm?"

// List emails
Show me my 10 most recent unread emails

// Get a specific email
Find the email from sarah@example.com about "Project Update"

Mensajes

Dominio	Descripción	Parámetros
`list_chats`	Lista de chats de iMessage y SMS disponibles	`includeParticipantDetails` (opcional, valor predeterminado: falso)
`get_messages`	Recibir mensajes desde la aplicación Mensajes	`limit` (opcional, predeterminado: 100)
`search_messages`	Buscar mensajes que contengan texto específico	`searchText` , `sender` (opcional), `chatId` (opcional), `limit` (opcional, predeterminado: 50), `daysBack` (opcional, predeterminado: 30)
`compose_message`	Abra la aplicación Mensajes con un mensaje precargado o envío automático	`recipient` (obligatorio), `body` (opcional), `auto` (opcional, predeterminado: falso)

Ejemplos

// List available chats
Show me my recent message conversations

// Get recent messages
Show me my last 20 messages

// Search messages
Find messages containing "dinner plans" from John in the last week

// Compose a message
Send a message to 555-123-4567 saying "I'll be there in 10 minutes"

Notas

Dominio	Descripción	Parámetros
`create`	Crea una nota con formato similar a Markdown	`title` , `content` , `format` (opcional con opciones de formato)
`createRawHtml`	Crear una nota con contenido HTML directo	`title` , `html`
`list`	Lista de notas, opcionalmente de una carpeta específica	`folder` (opcional)
`get`	Obtener una nota específica por título	`title` , `folder` (opcional)
`search`	Buscar notas que contengan texto específico	`query` , `folder` (opcional), `limit` (opcional, predeterminado: 5), `includeBody` (opcional, predeterminado: verdadero)

Ejemplos

// Create a new note with markdown formatting
Create a note titled "Meeting Minutes" with content "# Discussion Points\n- Project timeline\n- Budget review\n- Next steps" and format headings and lists

// Create a note with HTML
Create a note titled "Formatted Report" with HTML content "<h1>Quarterly Report</h1><p>Sales increased by <strong>15%</strong></p>"

// List notes
Show me all my notes in the "Work" folder

// Get a specific note
Show me my note titled "Shopping List"

// Search notes
Find notes containing "recipe" in my "Cooking" folder

Páginas

Dominio	Descripción	Parámetros
`create_document`	Crear un nuevo documento de Pages con texto sin formato	`content`

Ejemplos

// Create a new Pages document
Create a Pages document with the content "Project Proposal\n\nThis document outlines the scope and timeline for the upcoming project."

Arquitectura

El servidor applescript-mcp está construido con TypeScript y sigue una arquitectura modular:

Componentes principales

AppleScriptFramework ( framework.ts ): La clase de servidor principal que:
- Gestiona la comunicación del protocolo MCP
- Maneja el registro y ejecución de herramientas.
- Proporciona funcionalidad de registro
- Ejecuta comandos de AppleScript
Categorías ( src/categories/*.ts ): colecciones de scripts modulares organizadas por funcionalidad:
- Cada categoría contiene scripts relacionados (por ejemplo, calendario, sistema, notas)
- Las categorías se registran en el marco en index.ts
Tipos ( src/types/index.ts ): Interfaces de TypeScript que definen:
- ScriptDefinition : Estructura para scripts individuales
- ScriptCategory : Colección de scripts relacionados
- LogLevel : niveles de registro estándar
- FrameworkOptions : Opciones de configuración

Flujo de ejecución

El cliente envía una solicitud de herramienta a través del protocolo MCP
El servidor identifica la categoría y el script adecuados
El contenido del script se genera (estático o dinámicamente mediante una función)
AppleScript se ejecuta a través del comando osascript de macOS
Los resultados se devuelven al cliente.

Sistema de registro

El marco incluye un sistema de registro integral que:

Registra tanto el protocolo de registro stderr como el de MCP
Admite múltiples niveles de gravedad (depuración, información, advertencia, error, etc.)
Proporciona información detallada de ejecución para la resolución de problemas.

Desarrollo

Configuración

# Install dependencies
npm install

# Build the server
npm run build

# Launch MCP Inspector
# See: https://modelcontextprotocol.io/docs/tools/inspector
npx @modelcontextprotocol/inspector node path/to/server/index.js args...

Añadiendo nueva funcionalidad

1. Crear archivo de categoría

Crear src/categories/newcategory.ts :

import { ScriptCategory } from "../types/index.js";

export const newCategory: ScriptCategory = {
  name: "category_name",
  description: "Category description",
  scripts: [
    // Scripts will go here
  ],
};

2. Agregar scripts

{
  name: "script_name",
  description: "What the script does",
  schema: {
    type: "object",
    properties: {
      paramName: {
        type: "string",
        description: "Parameter description"
      }
    },
    required: ["paramName"]
  },
  script: (args) => `
    tell application "App"
      // AppleScript code using ${args.paramName}
    end tell
  `
}

3. Categoría de registro

Actualizar src/index.ts :

import { newCategory } from "./categories/newcategory.js";
// ...
server.addCategory(newCategory);

Desarrollo avanzado de scripts

Para scripts más complejos, puedes:

Utilice la generación dinámica de scripts :
script: (args) => { // Process arguments and build script dynamically let scriptContent = `tell application "App"\n`; if (args.condition) { scriptContent += ` // Conditional logic\n`; } scriptContent += `end tell`; return scriptContent; }
Procesar datos complejos :
// Example from Notes category function generateNoteHtml(args: any): string { // Process markdown-like syntax into HTML let processedContent = content; if (format.headings) { processedContent = processedContent.replace(/^# (.+)$/gm, '<h1>$1</h1>'); // ... } return processedContent; }

Depuración

Uso del inspector MCP

El Inspector MCP proporciona una interfaz web para probar y depurar su servidor:

npm run inspector

Explotación florestal

Habilite el registro de depuración configurando la variable de entorno:

DEBUG=applescript-mcp* npm start

Ejemplo de configuración

Después de ejecutar npm run build agregue lo siguiente a su archivo mcp.json :

{
  "mcpServers": {
    "applescript-mcp-server": {
      "command": "node",
      "args": ["/path/to/applescript-mcp/dist/index.js"]
    }
  }
}

Problemas comunes

Errores de permisos : Consultar Preferencias del sistema > Seguridad y privacidad > Privacidad > Automatización
Errores de script : Pruebe los scripts directamente en Script Editor.app antes de la integración
Problemas de comunicación : compruebe que los flujos de stdio no se redirigen
Acceso a la base de datos : algunas funciones (como Mensajes) requieren permiso de acceso completo al disco

Recursos

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Licencia MIT: consulte LICENCIA para obtener más detalles

You must be authenticated.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

local-only server

The server can only run on the client's local machine because it depends on local resources.

Permite que las aplicaciones LLM interactúen con macOS a través de AppleScript.

Related MCP Servers

MCP-Server-Playwright
Automata-Labs-team
A
security
A
license
A
quality
Enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment
Last updated -
10
327
85
JavaScript
MIT License
Puppeteer MCP Server
jwaldor
A
security
F
license
A
quality
Enables LLMs to perform web browsing tasks, take screenshots, and execute JavaScript using Puppeteer for browser automation.
Last updated -
4
15,502
1
JavaScript
MCP Puppeteer Linux Server
PhialsBasement
A
security
F
license
A
quality
Enables browser automation for LLMs on Linux display servers, supporting web interaction, screenshots, and JavaScript execution in a real browser.
Last updated -
7
5
4
JavaScript
MCP Toolbox
ai-zerolab
-
security
A
license
-
quality
A comprehensive toolkit that enhances LLM capabilities through the Model Context Protocol, allowing LLMs to interact with external services including command-line operations, file management, Figma integration, and audio processing.
Last updated -
17
Python
Apache 2.0

View all related MCP servers

Servidor MCP applescript-mcp

Características

Funciones planificadas

Prerrequisitos

Categorías disponibles

Calendario

Ejemplos

Portapapeles

Ejemplos

Descubridor

Ejemplos

Notificaciones

Ejemplos

Sistema

Ejemplos

iTerm

Ejemplos

Atajos

Ejemplos

Correo

Ejemplos

Mensajes

Ejemplos

Notas

Ejemplos

Páginas

Ejemplos

Arquitectura

Componentes principales

Flujo de ejecución

Sistema de registro

Desarrollo

Configuración

Añadiendo nueva funcionalidad

1. Crear archivo de categoría

2. Agregar scripts

3. Categoría de registro

Desarrollo avanzado de scripts

Depuración

Uso del inspector MCP

Explotación florestal

Ejemplo de configuración

Problemas comunes

Recursos

Contribuyendo

Licencia

Related MCP Servers

MCP-Server-Playwright

Puppeteer MCP Server

MCP Puppeteer Linux Server

MCP Toolbox

Appeared in Searches

New MCP Servers

MCP directory API