Sound Effects

🚀 MCP サウンドツール

このツールは、Model Context Protocol (MCP) を実装したもので、Cursor AI やその他の MCP 互換環境で効果音を再生するために使用されます。この Python 実装により、よりインタラクティブなコーディング体験のための音声フィードバックが提供されます。

✨ 主な機能

• 様々なイベント（完了、エラー、通知）の効果音を再生
• Model Context Protocol (MCP) を使用した標準化された統合
• クロスプラットフォーム対応（Windows、macOS、Linux）
• 効果音を設定可能

📦 インストール

Python バージョン互換性

このパッケージは Python 3.8 - 3.11 でテストされています。Python 3.12+ を使用している場合にエラー（特に BrokenResourceError または TaskGroup 例外）が発生する場合は、以前の Python バージョンを使用してみてください。

推奨：pipx を使用したインストール

pipx を使用してインストールすることをおすすめします。pipx はパッケージを隔離された環境にインストールし、コマンドをグローバルな PATH に追加します。

# まず pipx をインストール（未インストールの場合）
python -m pip install --user pipx
python -m pipx ensurepath

# mcp-sound-tool をインストール
pipx install mcp-sound-tool

この方法により、ツールは独自の隔離された環境を持ち、他のパッケージとの競合を避けることができます。

代替：pip を使用したインストール

pip を直接使用してインストールすることもできます。

pip install mcp-sound-tool

ソースコードからのインストール

ソースコードがある場合は、次のようにインストールできます。

git clone https://github.com/yourusername/mcp-sound-tool.git
cd mcp-sound-tool
pip install -e .

💻 使用例

音声ファイルの追加

音声ファイルを以下のパスに配置してください。

• Windows：%APPDATA%\mcp-sound-tool\resources\sounds
• macOS：~/Library/Application Support/mcp-sound-tool/resources/sounds
• Linux：~/.config/mcp-sound-tool/resources/sounds

MCP サーバーの起動

ターミナルまたはコマンドプロンプトで以下のコマンドを実行して MCP サーバーを起動します。

mcp-sound-server

デフォルトでは、サーバーはポート 5005 で動作します。

Cursor での設定

設定ファイル（通常は ~/.config/cursor/settings.json）を編集し、プラグイン部分に以下の内容を追加します。

{
  "plugins": {
    "mcp-sound": true
  }
}

その後、Cursor を再起動します。

音声 MCP 使用ガイド：AI モデル

基本的な使用法

音声イベントタイプを定義します。

1. 完了音声：操作が完了したときに音声を再生します。
2. エラー音声：エラーが検出されたときに音声を再生します。
3. 通知音声：ユーザーの注意が必要なときに音声を再生します。

高度な使用法

設定ファイル（通常は ~/.config/mcp-sound_TOOL/config.json）を編集し、以下の内容を追加します。

{
  "sounds": {
    "completion": "assets/complete.mp3",
    "error": "assets/error.mp3",
    "notification": "assets/notification.mp3"
  }
}

その後、MCP サービスを再起動します。

🔧 開発

開発依存関係のインストール

ターミナルまたはコマンドプロンプトで以下のコマンドを実行して開発依存関係をインストールします。

pip install -e ".[dev]"

テストの実行

以下のコマンドを実行してテストを実行します。

pytest tests/

謝辞

• SIAM-TheLegend が最初の sound-mcp JavaScript 実装を作成し、この Python バージョンの啓発になりました。
• MCP プロトコル開発者が強力な AI ツールの相互作用標準を作成しました。
• テストやドキュメントに貢献してくれたすべての貢献者に感謝します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細なライセンス内容は LICENSE ファイルを参照してください。