MIT License
🔔 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ライセンス
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
macOS 通知 MCP
Related MCP Servers
- MIT License