mcp-notify

最小限のMCPサーバーで、AIエージェントがタスクを完了したときや注意が必要なときに、通知音を再生し、システムバナーを表示します。

あらゆるMCPクライアントで動作します: Claude Desktop、Claude Code、Cursor、VS Code、opencode、Clineなど。3行の設定だけで、APIキー不要、ネットワーク呼び出し不要 — ローカルの音声機能と通知機能にのみアクセスします。

インストール

クライアントのMCP設定に追加します (Claude Desktopのclaude_desktop_config.json、Cursor / VS Codeのmcp.json、またはopencodeの設定):

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"]
    }
  }
}

(opencodeユーザー: mcpキーの下に同じ形で、"type": "local"と"command": ["npx", "-y", "@mrfqcentic/mcp-notify"]を指定します。)

Node.js >= 20が必要です。

Related MCP server: Notifications MCP Server

エージェントに呼び出させる

AGENTS.md / CLAUDE.md / システムプロンプトに1行追加します:

When a task is done or the user should be alerted, call the `notify` tool with a short title and a 1–2 sentence description of the result.

ツール

notify

サウンドを再生し、バナーを表示します。エージェントは常にtitle(最大50文字)とmessage(最大200文字)を提供します。

list_sounds

利用可能なサウンドと現在選択されているデフォルトを一覧表示します。

サウンドの選択

優先順位:

1. NOTIFY_SOUND環境変数 — 絶対パス。明示的で決定的

2. sounds/フォルダ内の名前がdefaultで始まるファイル (ピン留めしたもの)

3. sounds/フォルダ内の最初の音声ファイル (アルファベット順 — バンドルされたデフォルトとしてnotify-me.mp3が同梱されています)

4. assets/内の生成されたチャイム

5. システムサウンド (macOS Glass.aiff、Linux bell.oga)

ヒント: お気に入りのサウンドをsounds/default.mp3にリネームまたはコピーするか(NOTIFY_SOUNDを設定するか)ことで固定できます。

同梱されているsounds/notify-me.mp3は、ElevenLabsで商用ライセンスのもと生成されました。

{
  "mcpServers": {
    "mcp-notify": {
      "command": "npx",
      "args": ["-y", "@mrfqcentic/mcp-notify"],
      "env": { "NOTIFY_SOUND": "/absolute/path/to/your-sound.mp3" }
    }
  }
}

ヒント: 音声トラック付きのMP4ファイルも動作します (macOS afplayが音声ストリームを読み取ります)。

対応プラットフォーム

CI環境変数が設定されている場合、サウンドとバナーの再生はノーオペレーションになります (CIワークフローで自動設定されます)。これにより、音声のないマシンでもテストスイートを実行できます。

開発

npm install
npm run typecheck
npm test          # builds, then runs the e2e suite (sound + banner fire locally)

ライセンス

MIT — LICENSEを参照。