Audio MCP Server

🚀 音頻 MCP 服務器

音頻 MCP 服務器是一個提供音頻輸入/輸出功能的 MCP（模型上下文協議）服務器，可用於 AI 助手如Claude。藉助該服務器，Claude 能夠與您的計算機音頻系統進行交互，實現從麥克風錄音以及通過揚聲器播放音頻等操作。

🚀 快速開始

安裝服務器後，重啟Claude Desktop。您應該在輸入框中看到錘子圖標，表示工具可用。 嘗試詢問Claude：

• “我的系統上有哪些麥克風和揚聲器？”
• “用我的麥克風錄音5秒鐘。”
• “回放音頻記錄。”
• “通過我的計算機播放音頻文件。”

✨ 主要特性

• 列出音頻設備：查看系統上的所有麥克風和揚聲器
• 錄音：從任何麥克風捕獲音頻，具有可自定義的時長和質量
• 回放錄音：播放最近一次的錄音
• 音頻文件播放：通過揚聲器播放音頻文件
• 文本到語音：（未來實現佔位符）

📦 安裝指南

手動安裝

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

自動化安裝

使用包含的設置腳本來自動化安裝：

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"
      }
    }
  }
}

將路徑替換為您系統上的實際路徑。設置腳本會自動生成此配置。

可用工具

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文件以獲取詳細許可信息。