Apple 通知程序 MCP 服务器

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

先决条件

• macOS

• Node.js >= 18

• 与 MCP 兼容的客户端（Claude Desktop、Cline）

Related MCP server: Toast MCP Server

安装

通过 Smithery 安装

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

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

手动安装

1. 全局安装包：

npm install -g apple-notifier-mcp

2. 添加到您的 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文件。