apple-notifier-mcp
Apple 通知程序 MCP 服务器
通过任何与 MCP 兼容的客户端(如 Claude Desktop 或 Cline)发送原生 macOS 通知并与系统对话框交互。
先决条件
macOS
Node.js >= 18
与 MCP 兼容的客户端(Claude Desktop、Cline)
Related MCP server: apple-notifier-mcp
安装
通过 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文件。
Available Tools
5 toolsprompt_userA
Display a dialog prompt to get user input
Inputs: message (required), defaultAnswer, buttons, icon.
select_fileB
Open native file picker dialog
Inputs: prompt, defaultLocation, fileTypes, multiple.
send_notificationB
Send a notification on macOS using osascript
Inputs: title (required), message (required), subtitle, sound.
speakC
Speak text using macOS text-to-speech
Inputs: text (required), voice, rate.
take_screenshotC
Take a screenshot using macOS screencapture
Inputs: path (required), type (required), format, hideCursor, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinctly different macOS capability: user input, file selection, notification, text-to-speech, and screenshot. No overlap in purpose.
All tool names follow an imperative verb pattern with optional noun (e.g., prompt_user, select_file, send_notification, take_screenshot), and 'speak' fits as a single-verb imperative.
With 5 tools covering common macOS interactions, the count is well-scoped for a utility server—not too many and not too few.
The set covers core macOS utilities (notification, dialogs, TTS, screenshot), though the server name suggests a narrower focus on notifications. Minor additions like clipboard or open URL could enhance completeness.
Maintenance
Related MCP Connectors
A very simple remote MCP server that greets you, with a custom icon.
A simple MCP server built with FastMCP and python
Related MCP Servers
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server for sending iOS push notifications via Bark.313 npm4MIT
- AlicenseNot gradedqualityDmaintenanceEnhanced MCP server for sending native macOS notifications with terminal-notifier, interactive dialogs, text-to-speech, screenshots, and file selection.1MIT
- AlicenseBqualityDmaintenanceMCP server for sending Gotify push notifications to your devices.1MIT
- AlicenseAqualityDmaintenanceA lightweight MCP server that enables sending native desktop notifications with action buttons and text replies, compatible with any MCP client.129 npm1MIT