Audio Interface

🚀 オーディオMCPサーバー

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

✨ 主な機能

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

📦 インストール

前提条件

• Python 3.8以上
• システム上のオーディオ入出力デバイス

手順

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：特定の出力デバイスのインデックス（デフォルト：システムデフォルト）

トラブルシューティング

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

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

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

再生に問題がある場合

再生に問題がある場合は、以下の点を確認してください。

• 使用するデバイスのインデックスがシステム上に存在すること
• オーディオファイルのパスが正しいこと
• オーディオファイルの形式がサポートされていること

📄 ライセンス

このプロジェクトはMIT Licenseに準拠しています。

このサーバーを使用することで、Claudeをさまざまなオーディオ機能と簡単に統合し、コンピューターとより自然に対話できるようになります。