apple-notifier-mcp

Apple Notifier MCP サーバー

Claude Desktop や Cline などの MCP 互換クライアントを介してネイティブ macOS 通知を送信し、システム ダイアログを操作します。

前提条件

• macOS
• Node.js >= 18
• MCP 互換クライアント (Claude Desktop、Cline)

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Apple Notifier を自動的にインストールするには:

手動インストール

1. パッケージをグローバルにインストールします。

2. MCP 構成ファイルに以下を追加します:

Cline の場合 ( cline_mcp_settings.json ):

Claude Desktop の場合 ( claude_desktop_config.json ):

特徴

通知を送信する

カスタマイズ可能なコンテンツを含むネイティブ macOS 通知を表示します。

パラメータ:

• title (必須): 文字列 - 通知のタイトル
• message （必須）: 文字列 - メインメッセージの内容
• subtitle (オプション): 文字列 - 表示するサブタイトル
• sound （オプション）：ブール値 - デフォルトの通知音を再生するかどうか（デフォルト：true）

プロンプトを表示

ユーザー入力を取得するための対話型ダイアログ プロンプトを表示します。

パラメータ:

• message （必須）: 文字列 - プロンプトダイアログに表示するテキスト
• defaultAnswer (オプション): 文字列 - 事前入力するデフォルトのテキスト
• buttons (オプション): string[] - カスタムボタンラベル (最大3つ)
• icon （オプション）: 'note' | 'stop' | 'caution' - 表示するアイコン

テキスト読み上げ

macOS のテキスト読み上げ機能を使用します。

パラメータ:

• text （必須）: 文字列 - 読み上げるテキスト
• voice (オプション): 文字列 - 使用する音声 (デフォルトはシステム音声)
• rate (オプション): 数値 - 音声速度 (-50 ～ 50、デフォルトは 0)

スクリーンショットを撮る

macOS スクリーンキャプチャを使用してスクリーンショットをキャプチャします。

パラメータ:

• path （必須）: 文字列 - スクリーンショットを保存するパス
• type （必須）: 'fullscreen' | 'window' | 'selection' - スクリーンショットの種類
• format （オプション）: 'png' | 'jpg' | 'pdf' | 'tiff' - 画像形式
• hideCursor (オプション): ブール値 - カーソルを非表示にするかどうか
• shadow (オプション): boolean - ウィンドウの影を含めるかどうか (ウィンドウタイプのみ)
• timestamp (オプション): ブール値 - ファイル名にタイムスタンプを追加する

ファイルの選択

ネイティブ macOS ファイルピッカーダイアログを開きます。

パラメータ:

• prompt (オプション): 文字列 - プロンプトメッセージ
• defaultLocation (オプション): 文字列 - デフォルトのディレクトリパス
• fileTypes (オプション): オブジェクト - ファイルタイプフィルター (例: {"public.image": ["png", "jpg"]})
• multiple (オプション): ブール値 - 複数のファイルの選択を許可する

使用例

貢献

開発のセットアップとガイドラインについては、 CONTRIBUTING.md を参照してください。

ライセンス

MIT ライセンス - 詳細についてはLICENSEファイルを参照してください。