Sound Notification

🚀 音声通知MCP（JPN優先）

このプロジェクトは、WindsurfやCursorなどのAIコーディングアシスタントがユーザーの注意を促す必要があるときに、提示音を再生するためのMCPサーバーです。コードの作成が完了したり、ユーザーの承認が必要な場合に、提示音を再生することができます。

🚀 クイックスタート

この音声通知MCPは、AIコーディングアシスタントがユーザーに注意を促す際に提示音を再生するMCPサーバーです。コード作成完了や承認要求時に音声通知が可能です。

✨ 主な機能

• AIコーディングアシスタントがユーザーの注意を促す際に提示音を再生。
• 提示音をカスタマイズすることができる。

⚠️ 注意事項&免責事項

⚠️ 重要提示

• ※ 設定を追加する際には、必ず関連項目をルールにも追加してください。
• 現在はMacOSのみサポートしています（作成者がMacを使用しており、Windows環境を検証できないため）。
• MCPの呼び出しはLLMの判断によって決まるため、予期しないタイミングで音が鳴ったり、予期しない動作をすることがあります。
• Cursorの場合、コマンド実行前に提示音が鳴らないことがあります。
• Windsurfを使用すると、提示音が複数回再生されることがあります（電池消耗に注意してください）。

📦 インストール

前提条件

• Node.js (v18以上のバージョン)
• Yarnパッケージマネージャー

インストール手順

# リポジトリをクローンする
git clone <repository-url>
cd sound-notification-mcp

# 依存関係をインストールする
yarn install

# プロジェクトをビルドする
yarn build

これでインストールは完了です。

WindsurfまたはCursorでの設定

Cursor

/.cursor/mcp.jsonファイルにサンプル設定が用意されています。 （/.cursor/mcp.jsonに設定を書き込むと、起動時に自動的に設定が適用されます。）

Windsurf

グローバルルールファイルglobal_rules.mdとメモリバンクに以下の内容を追加してください。

### 音声通知MCP設定
- 通知が必要なときに音声通知を使用する。
- 提示音のパス：`/System/Library/Sounds/Glass.aiff`

これにより、AIアシスタントは必要なときに常に音声通知を使用するようになります。

💻 使用例

基本的な使用法

上記のインストールと設定を行った後、AIコーディングアシスタントがユーザーの注意を促すと、自動的に提示音が再生されます。

高度な使用法

提示音の変更

以下の部分のコードを変更します。

const SYSTEM_SOUND_PATH = '/System/Library/Sounds/Glass.aiff'; // MacOSのデフォルト提示音

MacOSで使用可能な音声ファイルは（/System/Library/Sounds/ディレクトリにあります）：

• Bottle.aiff
• Frog.aiff
• Funk.aiff
• Glass.aiff
• Hero.aiff
• Morse.aiff
• Ping.aiff
• Pop.aiff
• Purr.aiff
• Sosumi.aiff
• Submarine.aiff
• Tink.aiff

🔧 トラブルシューティング

音が再生されない場合

1. システム音量が正しく設定されていることを確認してください。
2. 指定された音声ファイルが存在することを確認してください。
3. エラー情報を取得するためにターミナル出力を確認してください。

MCPサーバーが起動しない場合

1. Node.jsとYarnが正しくインストールされていることを確認してください。
2. 依存関係が正常にインストールされていることを確認します：

   yarn install
   

3. ビルドエラーがないことを確認します：

   yarn build
   

📄 ライセンス

MITライセンス