MCP 服务器

apple-notifier-mcp

一个简单的 MCP 服务器，可以在 Mac 设备上发送通知。

操作系统自动化

访问服务器

Tools

send_notification

Send a notification on macOS using osascript

prompt_user

Display a dialog prompt to get user input

speak

Speak text using macOS text-to-speech

take_screenshot

Take a screenshot using macOS screencapture

select_file

Open native file picker dialog

README

Apple Notifier MCP 服务器

通过任何 MCP 兼容的客户端（如 Claude Desktop 或 Cline）发送原生 macOS 通知并与系统对话框交互。

前提条件

macOS
Node.js >= 18
一个 MCP 兼容的客户端 (Claude Desktop, Cline)

安装

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Apple Notifier：

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

手动安装

全局安装包：

npm install -g apple-notifier-mcp

添加到您的 MCP 配置文件：

对于 Cline (cline_mcp_settings.json):

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

对于 Claude Desktop (claude_desktop_config.json):

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

功能

发送通知

显示具有可自定义内容的本机 macOS 通知。

参数：

title (必需): string - 通知的标题
message (必需): string - 主要消息内容
subtitle (可选): string - 要显示的副标题
sound (可选): boolean - 是否播放默认通知声音（默认：true）

显示提示

显示交互式对话框提示以获取用户输入。

参数：

message (必需): string - 要在提示对话框中显示的文本
defaultAnswer (可选): string - 要预填充的默认文本
buttons (可选): string[] - 自定义按钮标签（最多 3 个）
icon (可选): 'note' | 'stop' | 'caution' - 要显示的图标

文本转语音

使用 macOS 文本转语音功能。

参数：

text (必需): string - 要说的文本
voice (可选): string - 要使用的声音（默认为系统声音）
rate (可选): number - 语速（-50 到 50，默认为 0）

截取屏幕截图

使用 macOS screencapture 捕获屏幕截图。

参数：

path (必需): string - 保存屏幕截图的路径
type (必需): 'fullscreen' | 'window' | 'selection' - 屏幕截图的类型
format (可选): 'png' | 'jpg' | 'pdf' | 'tiff' - 图像格式
hideCursor (可选): boolean - 是否隐藏光标
shadow (可选): boolean - 是否包含窗口阴影（仅适用于窗口类型）
timestamp (可选): boolean - 将时间戳添加到文件名

文件选择

打开本机 macOS 文件选择器对话框。

参数：

prompt (可选): string - 提示消息
defaultLocation (可选): string - 默认目录路径
fileTypes (可选): object - 文件类型过滤器（例如，{"public.image": ["png", "jpg"]}）
multiple (可选): boolean - 允许选择多个文件

使用示例

// 发送通知
await client.use_mcp_tool("apple-notifier", "send_notification", {
  title: "Hello",
  message: "World",
  sound: true
});

// 显示提示
const result = await client.use_mcp_tool("apple-notifier", "prompt_user", {
  message: "What's your name?",
  defaultAnswer: "John Doe",
  buttons: ["OK", "Cancel"]
});

// 语音朗读文本
await client.use_mcp_tool("apple-notifier", "speak", {
  text: "Hello, world!",
  voice: "Samantha",
  rate: -20
});

// 截取屏幕截图
await client.use_mcp_tool("apple-notifier", "take_screenshot", {
  path: "screenshot.png",
  type: "window",
  format: "png"
});

// 选择文件
const files = await client.use_mcp_tool("apple-notifier", "select_file", {
  prompt: "Select images",
  fileTypes: {
    "public.image": ["png", "jpg", "jpeg"]
  },
  multiple: true
});