Audio Interface

🚀 音頻 MCP 服務器

這是一個專為 AI 助手（如 Claude）打造的 MCP（模型上下文協議）服務器，它賦予了 Claude 與計算機音頻系統交互的能力，支持從麥克風錄音，也能通過揚聲器播放音頻，極大地豐富了 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

自動化安裝

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

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 與各種音頻功能集成，讓它與計算機的交互更加自然流暢。