Macos Notifier

🚀 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

手動安裝

1. 全局安裝包：

npm install -g apple-notifier-mcp

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