🚀 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 文件。