✨ Notifications MCP Server ✨

概要

タスクの完了時に AI エージェントが通知音を再生できる Model Context Protocol サーバーです。この TypeScript ベースの MCP サーバーは、npx ですぐに使える同梱サウンド付きの、シンプルで設定可能な通知システムを提供します。

✨ 機能

🔧 ツール

• notify - タスク完了時にデスクトップのトースト通知を表示したり、サウンドを再生したりできます（要約におすすめです）
  • message（必須）：完了したタスクの通知メッセージ／要約
  • title（任意）：トースト通知のタイトル（デフォルトは "Task Completed"）
  • mode（任意）："toast" | "sound" | "both"（デフォルトは "both"）
  • sound（任意）：再生するサウンド名。デフォルト設定を上書きします
  • Windows、macOS、Linux にすぐに対応しています！
• play_notification - タスクの完了を知らせる通知音を再生します
  • 通知とともに記録／表示するための任意の message パラメーターを受け取ります
  • クロスプラットフォームのサウンド再生に対応しています（Windows、macOS、Linux）
  • 同梱サウンドで動作します - 手動でのダウンロードは不要です！

🎵 内蔵サウンドライブラリ

パッケージに同梱された高品質な通知音 5 種類：

• cosmic - 宇宙をテーマにした通知音 🌌
• fairy - 魔法のような幻想的な音 🧚‍♀️
• gentle - 柔らかく心地よいデフォルトのサウンド（デフォルト） 🔔
• pleasant - バランスの取れたプロフェッショナルな音 📞
• retro - 懐かしいレトロ調の通知音 🕹️
• random - 5 種類のサウンドからランダムに再生します 🎲

🚀 クイックスタート

オプション 1：同梱サウンドを使用する（おすすめ）⭐

npx で実行するだけです。サウンドも含まれています！

{
  "mcpServers": {
    "notifications": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/notification-mcp"]
    }
  }
}

オプション 2：別の同梱サウンドを選ぶ

{
  "mcpServers": {
    "notifications": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/notification-mcp"],
      "env": {
        "MCP_NOTIFICATION_SOUND": "cosmic"
      }
    }
  }
}

オプション 3：毎回ランダムなサウンドを再生する 🎲

{
  "mcpServers": {
    "notifications": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/notification-mcp"],
      "env": {
        "MCP_NOTIFICATION_SOUND": "random"
      }
    }
  }
}

オプション 4：独自のカスタムサウンドを使用する

{
  "mcpServers": {
    "notifications": {
      "command": "npx",
      "args": ["-y", "@pinkpixel/notification-mcp"],
      "env": {
        "MCP_NOTIFICATION_SOUND_PATH": "C:\\path\\to\\your\\sound.mp3"
      }
    }
  }
}

⚙️ 設定

通知音は環境変数を使用して設定できます。

環境変数

変数	説明	デフォルト
MCP_NOTIFICATION_SOUND	同梱サウンドから選択します：cosmic、fairy、gentle、pleasant、retro、random	gentle
MCP_NOTIFICATION_SOUND_PATH	独自の MP3 ファイルへの絶対パス（同梱サウンドを上書きします）	null

優先順位

1. カスタムパス（MCP_NOTIFICATION_SOUND_PATH） - 最優先
2. 同梱サウンド（MCP_NOTIFICATION_SOUND） - 5 種類の収録サウンドから選択
3. デフォルト - 何も指定されていない場合は gentle のチャイム

💻 使用方法

設定後、MCP クライアントから統合された notify ツール、または音声専用の play_notification ツールを呼び出せます。

1. トースト＋サウンド通知の統合（推奨）

await client.request({
  method: "tools/call",
  params: {
    name: "notify",
    arguments: {
      title: "Build Succeeded",
      message: "Antigravity successfully tested the package version 0.2.0! 🚀",
      mode: "both", // "toast", "sound", or "both"
      sound: "cosmic" // optional override
    }
  }
});

2. 音声のみの通知

await client.request({
  method: "tools/call",
  params: {
    name: "play_notification",
    arguments: {
      message: "Task completed successfully! 🎉"
    }
  }
});

🛠️ 開発

ローカル開発環境のセットアップ

# Clone the repository
git clone https://github.com/pinkpixel-dev/notification-mcp.git
cd notification-mcp

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

ローカル開発の設定

{
  "mcpServers": {
    "notifications": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "MCP_NOTIFICATION_SOUND": "retro"
      }
    }
  }
}

デバッグ

インタラクティブなデバッグには、MCP Inspectorを使用してください。

npm run inspector

Inspector では、ブラウザー上で MCP サーバーをテストできるウェブインターフェースを利用できます。

📦 インストール方法

NPX（推奨）

インストールは不要です。サウンドは自動的に同梱されます。

npx @pinkpixel/notification-mcp

グローバルインストール

npm install -g @pinkpixel/notification-mcp
notification-mcp

ローカルインストール

npm install @pinkpixel/notification-mcp
npx notification-mcp

🎵 サウンドファイル

すべてのサウンドファイルは sounds/ ディレクトリにあり、パッケージのインストール時に自動的に含まれます。

• Cosmic：sounds/cosmic_chime.mp3 - 🌌 宇宙をテーマにしたサウンド
• Fairy：sounds/fairy_chime.mp3 - 🧚‍♀️ 魔法のようなサウンド
• Gentle：sounds/gentle_chime.mp3 - 🔔 デフォルト（ソフト）
• Pleasant：sounds/pleasant_chime.mp3 - 📞 プロフェッショナル
• Retro：sounds/retro_chime.mp3 - 🕹️ レトロ
• Random：MCP_NOTIFICATION_SOUND=random を設定 - 🎲 どのサウンドが鳴るかはお楽しみ！

🤝 貢献

貢献を歓迎します！ガイドラインについては、CONTRIBUTING.mdをご覧ください。

📄 ライセンス

このプロジェクトは MIT ライセンスと Apache 2.0 ライセンスのデュアルライセンスです。詳細については、LICENSEファイルをご覧ください。

🌟 Pink Pixel について

• ウェブサイト： pinkpixel.dev
• GitHub： github.com/pinkpixel-dev
• Discord： @sizzlebop

---

❤️ を込めて Pink Pixel が制作 ✨