Play Sound MCP Server

🚀 MCP Play Sound Server

このサーバーは、AIエージェントに音声再生機能を提供するModel Context Protocol (MCP) サーバーです。コーディングタスクが完了した際に、AIエージェントが音声通知を再生できるようになります。

⚠️ 重要提示

これは現在macOSでのみテストされている初期バージョン/概念実証です。将来的なバージョンでは、追加のプラットフォームをサポート予定です。

✨ 主な機能

• 音声通知：AIタスクが完了したときに音声アラートを再生します。
• デフォルト音声：すぐに使える通知音声が同梱されています。
• カスタム音声：カスタムオーディオファイル（WAV、MP3、FLAC、OGG、M4A）をサポートします。
• インテリジェントフォールバック：カスタム音声が再生できない場合、自動的にデフォルト音声にフォールバックします。
• macOSサポート：現在、AFPlayとSimpleAudioを使用してmacOSでテストされています。

📦 インストール

開発環境のセットアップ

1. クローンとインストール：

git clone <repository-url>
cd play-sound-mcp-server
python -m venv .venv
source .venv/bin/activate  # Windowsの場合: .venv\Scripts\activate
pip install -e ".[dev]"

2. Claude Desktopの設定： claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "play-sound": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/play-sound-mcp-server",
        "run",
        "mcp-server-play-sound"
      ]
    }
  }
}

3. テスト：Claude Desktopを再起動して、「Can you play a notification sound?」と質問します。

📚 ドキュメント

設定

環境変数（オプション）：

• CUSTOM_SOUND_PATH：カスタムオーディオファイルのパス
• VOLUME_LEVEL：再生音量（0.0 - 1.0、デフォルト: 0.8）
• ENABLE_FALLBACK：デフォルト音声へのフォールバックを有効にする（デフォルト: true）
• AUDIO_DEVICE：特定のオーディオ出力デバイス名（例: "Mac Studio Speakers"）

利用可能なツール

play_notification_sound

通知音を再生してユーザーにアラートを通知します。

パラメーター：

• custom_sound_path（オプション）：カスタムオーディオファイルのパス
• message（オプション）：通知のコンテキストメッセージ

get_audio_status

現在のオーディオシステムの状態と設定を返します。

test_audio_playback

オーディオ再生機能をテストします。

パラメーター：

• use_custom（オプション）：設定されている場合、カスタム音声でテストします。

list_audio_devices

システム上のすべての利用可能なオーディオ出力デバイスをリストします。

戻り値：

• 利用可能なオーディオデバイスとそのプロパティのリスト
• 現在設定されているデバイス（ある場合）
• デフォルトデバイスの情報

開発

前提条件

• Python 3.10以上
• uv（推奨）またはpip

テスト

pytest tests/

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

謝辞

• Model Context Protocol by Anthropic
• Pythonオーディオライブラリのメンテナーの皆様