MCP Play Sound Server

MCP Play Sound Server

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

⚠️ 初期バージョン／概念実証 現在は初期実装で、macOS のみでテストされています。今後のバージョンでは、ほかのプラットフォームにも対応する予定です。

機能

• 音声通知：AI タスクの完了時に通知音を再生します
• デフォルトのサウンド：すぐに使える通知音を同梱しています
• カスタム音声：カスタム音声ファイル（WAV、MP3、FLAC、OGG、M4A）に対応しています
• インテリジェントなフォールバック：カスタム音声の再生に失敗した場合、デフォルトのサウンドに自動で切り替わります
• macOS 対応：現在は macOS で AFPlay と SimpleAudio を使用してテストされています

インストールとセットアップ

開発環境のセットアップ

1. クローンしてインストール：

git clone <repository-url>
cd play-sound-mcp-server
python -m venv .venv
source .venv/bin/activate  # On 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 を再起動し、「通知音を再生できますか？」と尋ねます。

設定

環境変数（任意）：

• 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 — 詳細は LICENSE ファイルを参照してください。

謝辞

• Anthropic による Model Context Protocol
• Python 音声ライブラリのメンテナーの皆さま