Skip to main content
Glama

macOS Notification MCP

by devizor

🔔 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 コマンド ( afplayosascriptsay ) を使用します
  • 🔌 FastMCP : AI通信用のFastMCPフレームワーク上に構築

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

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

📄 ライセンス

MITライセンス

Related MCP Servers

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/devizor/macOS-Notification-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server