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.

Apple 通知程序 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 桌面（ claude_desktop_config.json ）：

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

特征

发送通知

显示具有可自定义内容的原生 macOS 通知。

参数：

title （必需）：字符串 - 通知的标题
message （必需）：字符串 - 主要消息内容
subtitle （可选）：字符串 - 要显示的字幕
sound （可选）：布尔值 - 是否播放默认通知声音（默认值：true）

显示提示

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

参数：

message （必需）：字符串 - 提示对话框中显示的文本
defaultAnswer （可选）：字符串 - 预填充的默认文本
buttons （可选）：string[] - 自定义按钮标签（最多 3 个）
icon （可选）：'注意' | '停止' | '警告' - 要显示的图标

文本转语音

使用 macOS 文本转语音功能。

参数：

text （必需）：字符串 - 文本朗读
voice （可选）：字符串 - 要使用的语音（默认为系统语音）
rate （可选）：数字 - 语速（-50 到 50，默认为 0）

截取屏幕截图

使用 macOS 屏幕截图功能捕获屏幕截图。

参数：

path （必需）：字符串 - 保存屏幕截图的路径
type （必需）：'全屏' | '窗口' | '选择' - 屏幕截图类型
format （可选）：'png' | 'jpg' | 'pdf' | 'tiff' - 图像格式
hideCursor （可选）：布尔值 - 是否隐藏光标
shadow （可选）：布尔值 - 是否包含窗口阴影（仅适用于窗口类型）
timestamp （可选）：布尔值 - 将时间戳添加到文件名

文件选择

打开原生 macOS 文件选择器对话框。

参数：

prompt （可选）：string - 提示信息
defaultLocation （可选）：字符串 - 默认目录路径
fileTypes （可选）：对象 - 文件类型过滤器（例如，{“public.image”：[“png”，“jpg”]}）
multiple （可选）：布尔值 - 允许选择多个文件

示例用法

// 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
});

贡献

请参阅CONTRIBUTING.md了解开发设置和指南。

执照

MIT 许可证 - 有关详细信息，请参阅LICENSE文件。

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

一个简单的 MCP 服务器，可以向 mac 设备发送通知。