Skip to main content
Glama
deenesjakoruzh
devizor

macOS Notification MCP

by devizor
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

🔔 macOS 通知 MCP

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

✨ 特徴

  • 🔊サウンド通知: 潜水艦、ピン、ティンクなどのシステムサウンドを再生します

  • 💬バナー通知：カスタマイズ可能なタイトル、メッセージ、サブタイトルで視覚的な通知を表示します

  • 🗣️音声通知：音声、速度、音量を調整してテキストを音声に変換します

  • 🎙️音声管理: 利用可能なシステム音声を一覧表示して選択する

  • 🧪テストツール: すべての通知方法を検証するための診断ユーティリティ

Related MCP server: Notifications MCP Server

🚀 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 deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP Notifications Server

    konstzv
    F
    license
    B
    quality
    D
    maintenance
    Enables Claude and other MCP clients to display native macOS notifications with customizable titles, messages, icons, and sounds through the macOS Notification Center.
    1
    6 npm
    -

  • Notifications MCP Server

    ohqay
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to send native macOS notifications for task completion alerts and reminders. Supports interactive features like custom system sounds, action buttons, and user replies directly from the notification center.
    201 npm
    MIT

  • MCPing

    toolprint
    A
    license
    B
    quality
    D
    maintenance
    Enables AI assistants to send desktop notifications on macOS with rich formatting, urgency levels, and sound options.
    1
    11 npm
    1
    MIT