apple-notifier-mcp

local-only server

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

Integrations

  • Provides access to Apple's macOS system services including notifications, dialogs, text-to-speech, screenshot capture, and file selection functionality.

  • Enables sending native macOS notifications, displaying interactive dialog prompts, using text-to-speech capabilities, capturing screenshots, and accessing the native file picker dialog.

Servidor MCP de Apple Notifier

Envía notificaciones nativas de macOS e interactúa con los cuadros de diálogo del sistema a través de cualquier cliente compatible con MCP como Claude Desktop o Cline.

Prerrequisitos

  • macOS
  • Node.js >= 18
  • Un cliente compatible con MCP (Claude Desktop, Cline)

Instalación

Instalación mediante herrería

Para instalar Apple Notifier para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install apple-notifier-mcp --client claude

Instalación manual

  1. Instalar el paquete globalmente:
npm install -g apple-notifier-mcp
  1. Agregue a su archivo de configuración de MCP:

Para Cline ( cline_mcp_settings.json ):

{ "mcpServers": { "apple-notifier": { "command": "apple-notifier-mcp" } } }

Para Claude Desktop ( claude_desktop_config.json ):

{ "mcpServers": { "apple-notifier": { "command": "apple-notifier-mcp" } } }

Características

Enviar notificaciones

Muestra notificaciones nativas de macOS con contenido personalizable.

Parámetros:

  • title (obligatorio): cadena: el título de la notificación
  • message (obligatorio): cadena: el contenido principal del mensaje
  • subtitle (opcional): cadena - Un subtítulo para mostrar
  • sound (opcional): booleano - Si se reproducirá el sonido de notificación predeterminado (predeterminado: verdadero)

Indicaciones de visualización

Muestra mensajes de diálogo interactivos para obtener información del usuario.

Parámetros:

  • message (obligatorio): cadena: texto que se mostrará en el cuadro de diálogo de solicitud
  • defaultAnswer (opcional): cadena - Texto predeterminado para rellenar previamente
  • buttons (opcional): string[] - Etiquetas de botones personalizadas (máximo 3)
  • icon (opcional): 'nota' | 'detener' | 'precaución' - Icono para mostrar

Texto a voz

Utilice las capacidades de texto a voz de macOS.

Parámetros:

  • text (obligatorio): cadena - Texto a leer
  • voice (opcional): cadena - Voz a utilizar (predeterminada: voz del sistema)
  • rate (opcional): número - Velocidad de voz (-50 a 50, predeterminado 0)

Tomar capturas de pantalla

Captura capturas de pantalla usando la captura de pantalla de macOS.

Parámetros:

  • path (obligatorio): cadena - Ruta donde guardar la captura de pantalla
  • type (obligatorio): 'pantalla completa' | 'ventana' | 'selección' - Tipo de captura de pantalla
  • format (opcional): 'png' | 'jpg' | 'pdf' | 'tiff' - Formato de imagen
  • hideCursor (opcional): booleano - Si se debe ocultar el cursor
  • shadow (opcional): booleano - Si se debe incluir la sombra de la ventana (solo para el tipo de ventana)
  • timestamp (opcional): booleano - Agrega una marca de tiempo al nombre del archivo

Selección de archivos

Abrir el cuadro de diálogo de selección de archivos nativos de macOS.

Parámetros:

  • prompt (opcional): cadena - Mensaje de aviso
  • defaultLocation (opcional): cadena - Ruta de directorio predeterminada
  • fileTypes (opcional): objeto - Filtro de tipo de archivo (por ejemplo, {"public.image": ["png", "jpg"]})
  • multiple (opcional): booleano - Permitir la selección de múltiples archivos

Ejemplo de uso

// Send a notification await client.use_mcp_tool("apple-notifier", "send_notification", { title: "Hello", message: "World", sound: true }); // Show a prompt const result = await client.use_mcp_tool("apple-notifier", "prompt_user", { message: "What's your name?", defaultAnswer: "John Doe", buttons: ["OK", "Cancel"] }); // Speak text await client.use_mcp_tool("apple-notifier", "speak", { text: "Hello, world!", voice: "Samantha", rate: -20 }); // Take a screenshot await client.use_mcp_tool("apple-notifier", "take_screenshot", { path: "screenshot.png", type: "window", format: "png" }); // Select files const files = await client.use_mcp_tool("apple-notifier", "select_file", { prompt: "Select images", fileTypes: { "public.image": ["png", "jpg", "jpeg"] }, multiple: true });

Contribuyendo

Consulte CONTRIBUTING.md para conocer la configuración y las pautas de desarrollo.

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor MCP simple que puede enviar notificaciones en dispositivos Mac.

  1. Prerequisites
    1. Installation
      1. Installing via Smithery
      2. Manual Installation
    2. Features
      1. Send Notifications
      2. Display Prompts
      3. Text-to-Speech
      4. Take Screenshots
      5. File Selection
    3. Example Usage
      1. Contributing
        1. License
          ID: t1w1dq4wy4