macOS 通知 MCP

🔔 macOS 通知 MCP

AI アシスタントが macOS 通知、サウンド、テキスト読み上げをトリガーできるようにするモデルコンテキストプロトコル (MCP) サーバー。

✨ 特徴

🔊サウンド通知: 潜水艦、ピン、ティンクなどのシステムサウンドを再生します
💬バナー通知：カスタマイズ可能なタイトル、メッセージ、サブタイトルで視覚的な通知を表示します
🗣️音声通知：音声、速度、音量を調整してテキストを音声に変換します
🎙️音声管理: 利用可能なシステム音声を一覧表示して選択する
🧪テストツール: すべての通知方法を検証するための診断ユーティリティ

🚀 uvx のクイックスタート（推奨）

このツールを使用する最も速い方法は、永続的なインストールなしでパッケージを実行するuvxを使用することです。

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the MCP server directly (no installation needed)
uvx macos-notification-mcp

⚙️ Claude デスクトップを設定する

これを Claude Desktop 構成 ( ~/Library/Application Support/Claude/claude_desktop_config.json ) に追加します。

{
  "mcpServers": {
    "macos-notification-mcp": {
      "command": "uvx",
      "args": ["macos-notification-mcp"]
    }
  }
}

次に、Claude Desktop を再起動します。

📦 代替インストール方法

標準インストール:

pip install macos-notification-mcp

ソースからインストール:

git clone https://github.com/devizor/macos-notification-mcp
cd macos-notification-mcp
pip install .

🛠️ 利用可能な通知ツール

🔊 サウンド通知

sound_notification(sound_name="Submarine")

使用可能なサウンド: Basso、Blow、Bottle、Frog、Funk、Glass、Hero、Morse、Ping、Pop、Purr、Sosumi、Submarine、Tink

💬 バナー通知

banner_notification(
    title="Task Complete",
    message="Your analysis is ready",
    subtitle=None,  # Optional
    sound=False,    # Optional: Play sound with notification
    sound_name=None # Optional: Specify system sound
)

🗣️ 音声通知

speak_notification(
    text="The process has completed",
    voice=None,     # Optional: System voice to use
    rate=150,       # Optional: Words per minute (default: 150)
    volume=1.0      # Optional: Volume level 0.0-1.0
)

🎙️ 音声管理

list_available_voices()  # Lists all available text-to-speech voices

🧪 テスト

test_notification_system()  # Tests all notification methods

🔒 実装の詳細

⏱️レート制限: 通知は0.5秒の最小間隔で一度に1つずつ処理されます
🔄キューイング：複数の通知リクエストは順番に処理されます
🪟 OS 統合: ネイティブ macOS コマンド ( afplay 、 osascript 、 say ) を使用します
🔌 FastMCP : AI通信用のFastMCPフレームワーク上に構築

⚠️ トラブルシューティング

🔐権限: システム設定→通知で通知が許可されていることを確認してください
⏳タイミング: 一度に処理される通知は 1 つだけです
🌐環境: コマンドを直接使用する場合（uvxではない）、フルパスを使用する必要がある場合があります

📄 ライセンス

MITライセンス

macOS Notification MCP

Integrations