JinDaGe - macOS Notifier MCP Details

article

README

🚀 Apple_notifier MCP 服务器

Apple_notifier MCP 服务器可通过任何兼容的 MCP 客户端（如 Claude Desktop 或 Cline），发送原生 macOS 通知并交互式地与系统对话框进行操作。

🚀 快速开始

使用 Apple_notifier MCP 服务器前，需要确保满足以下先决条件：

macOS 操作系统
Node.js 版本 >= 18
一个兼容的 MCP 客户端（Claude Desktop、Cline）

📦 安装指南

使用 Smithery 进行自动安装

通过 Smithery 可自动安装 Apple_notifier for Claude Desktop：

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（必填）：字符串 - 通知的标题
message（必填）：字符串 - 主要消息内容
subtitle（可选）：字符串 - 显示的子标题
sound（可选）：布尔值 - 是否播放默认提示音（默认：true）

显示提示框

展示交互式对话框以获取用户输入。参数说明：

message（必填）：字符串 - 提示框中显示的文字
defaultAnswer（可选）：字符串 - 预设的默认答案
buttons（可选）：字符串数组 - 自定义按钮标签（最多 3 个）
icon（可选）：'note' | 'stop' | 'caution' - 显示的图标

文本转语音

利用 macOS 的文本转语音功能。参数说明：

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

截取屏幕

使用 macOS 的 screencapture 工具截取屏幕。参数说明：

path（必填）：字符串 - 截图保存路径
type（必填）：'fullscreen' | 'window' | 'selection' - 截图类型
quality（可选）：数字 - 图片质量（范围：0 到 100）
format（可选）：'png' | 'jpeg' - 图片格式

提示选择文件

展示对话框以允许用户选择文件。参数说明：

multiple（可选）：布尔值 - 是否允许多个文件选择
accept（可选）：字符串数组 - 接受的文件类型过滤器

💻 使用示例

基础用法

// 发送通知
new Notification({
  title: "提醒",
  message: "您有一条新消息。",
  sound: true
});

// 显示提示框
Dialog.prompt({
  message: "请输入您的姓名：",
  defaultText: "张三"
}).then(name => {
  console.log(`用户输入的姓名是：${name}`);
});

// 文本转语音
Speech.speak("您好，这是测试消息。", { 
  voice: 'zh-CN',
  rate: 1.5 
});

// 截取屏幕
ScreenCapture.capture('selection', '/Users/username/Desktop/screenshot.png');

// 提示选择文件
FilePicker.show({
  multiple: true,
  accept: ['image/*']
}).then(files => {
  console.log(`用户选择了 ${files.length} 个文件。`);
});

📚 详细文档

请参考 CONTRIBUTING.md 获取开发环境搭建和贡献指南。

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

macOS Notifier