Audio MCP Server

🚀 オーディオMCPサーバー

このサーバーは、ClaudeなどのAIアシスタントにオーディオ入出力機能を提供するMCP（モデルコンテキストプロトコル）サーバーです。Claudeがコンピューターのオーディオシステムと相互作用できるようにし、マイクからの録音やスピーカーを通じたオーディオ再生を可能にします。

✨ 主な機能

• オーディオデバイスの一覧表示：システム上のすべてのマイクとスピーカーを確認できます。
• 録音：任意のマイクからオーディオをキャプチャし、録音時間と品質をカスタマイズできます。
• 録音の再生：最後に録音したオーディオを再生します。
• オーディオファイルの再生：スピーカーを通じてオーディオファイルを再生します。
• テキスト読み上げ：（将来的に実装予定）

📦 インストール

1. このリポジトリをクローンするか、ファイルをダウンロードしてコンピューターに保存します。

git clone https://github.com/GongRzhe/Audio-MCP-Server.git
cd Audio-MCP-Server

2. 仮想環境を作成し、依存関係をインストールします。

# Windows
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt

# macOS/Linux
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

3. または、含まれているセットアップスクリプトを使用してインストールを自動化できます。

python setup_mcp.py

📚 ドキュメント

Claudeデスクトップの設定

このサーバーをClaude Desktopと一緒に使用するには、Claude Desktopの設定ファイルに以下の内容を追加します。

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "audio-interface": {
      "command": "/path/to/your/.venv/bin/python",
      "args": [
        "/path/to/your/audio_server.py"
      ],
      "env": {
        "PYTHONPATH": "/path/to/your/audio-mcp-server"
      }
    }
  }
}

パスをシステム上の実際のパスに置き換えてください。セットアップスクリプトはこの設定を自動的に生成します。

💻 使用例

サーバーをインストールした後、Claude Desktopを再起動します。入力ボックスにハンマーアイコンが表示され、ツールが使用可能であることを示します。 Claudeに以下のような質問を試してみてください。

• “私のシステム上にあるマイクとスピーカーは何ですか？”
• “私のマイクで5秒間録音してください。”
• “録音したオーディオを再生してください。”
• “私のコンピューターでオーディオファイルを再生してください。”

利用可能なツール

list_audio_devices

システム上のすべてのオーディオ入力と出力デバイスを一覧表示します。

record_audio

マイクから録音します。 パラメーター：

• duration：録音時間（秒）（デフォルト：5）
• sample_rate：サンプリングレート（ヘルツ）（デフォルト：44100）
• channels：オーディオチャンネル数（デフォルト：1）
• device_index：特定の入力デバイスのインデックス（デフォルト：システムデフォルト）

play_latest_recording

最後に録音したオーディオを再生します。

play_audio

将来的にテキスト読み上げ機能を実装するためのプレースホルダーです。 パラメーター：

• text：音声に変換するテキスト
• voice：使用する音声（デフォルト：“default”）

play_audio_file

スピーカーを通じてオーディオファイルを再生します。 パラメーター：

• file_path：オーディオファイルのパス
• device_index：特定の出力デバイスのインデックス（デフォルト：システムデフォルト）

🔧 技術詳細

デバイスが見つからない場合

オーディオデバイスが見つからない場合は、以下を確認してください。

• マイクとスピーカーが正しく接続されていること
• オペレーティングシステムがデバイスを認識していること
• オーディオデバイスにアクセスする権限があること

再生に問題がある場合

録音を再生できない場合は、以下を確認してください。

• スピーカーが正しく接続され、有効になっていること
• 音量設定が正しいこと
• 録音ファイルの形式が互換性があること

⚠️ 重要提示

このプロジェクトにはマイクとスピーカーのハードウェアサポートが必要で、デバイスにアクセスするために管理者権限が必要になる場合があります。一部のシステムでは、オーディオ設定を調整するか、異なるオーディオインターフェイスを使用する必要がある場合があります。

📄 ライセンス

詳細なライセンス情報については、プロジェクトのLICENSEファイルを参照してください。