Macos Notifier

🚀 Apple_notifier MCP サーバー

任意の互換性のあるMCPクライアント（Claude DesktopやClineなど）を通じて、ネイティブのmacOS通知を送信し、システムダイアログと対話的に操作できます。

🚀 クイックスタート

このサーバーを使用することで、任意の互換性のあるMCPクライアントを通じて、macOSの通知やダイアログ操作を行うことができます。以下の手順でセットアップしてください。

📦 インストール

前提条件

• macOS オペレーティングシステム
• Node.js バージョン >= 18
• 互換性のあるMCPクライアント（Claude Desktop、Cline）

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 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 ファイルを参照してください。