Voice MCP

🚀 voice-mcp - Claude Code的語音模式

voice-mcp是一個模型上下文協議（MCP）服務器，它能讓你與Claude及其他大語言模型（LLMs）進行語音交互。你只需要一個OpenAI API密鑰，以及麥克風和揚聲器即可使用。

🚀 快速開始

Claude Code的設置

export OPENAI_API_KEY=your-openai-key
claude mcp add voice-mcp uvx voice-mcp
# 或者，運行容器鏡像
# docker pull ghcr.io/mbailey/voice-mcp:latest
# claude mcp add voice-mcp podman run -e OPENAI_API_KEY ghcr.io/mbailey/voice-mcp:latest
claude

你可以嘗試說："讓我們進行語音對話"

Claude桌面端設置

將以下內容添加到Claude桌面端的配置文件中：

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

{
  "mcpServers": {
    "voice-mcp": {
      "command": "uvx",
      "args": ["voice-mcp"],
      "env": {
        "OPENAI_API_KEY": "your-openai-key"
      }
    }
  }
}

{
  "mcpServers": {
    "voice-mcp": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "--device", "/dev/snd",
        "-e", "PULSE_RUNTIME_PATH=/run/user/1000/pulse",
        "-v", "/run/user/1000/pulse:/run/user/1000/pulse",
        "ghcr.io/mbailey/voice-mcp:latest"
      ],
      "env": {
        "OPENAI_API_KEY": "your-openai-key"
      }
    }
  }
}

{
  "mcpServers": {
    "voice-mcp": {
      "command": "voice-mcp",
      "env": {
        "OPENAI_API_KEY": "your-openai-key"
      }
    }
  }
}

✨ 主要特性

• 🎙️ 語音對話：與Claude進行語音交流，提問並聽取回答。
• 🔄 多種傳輸方式：支持本地麥克風或基於LiveKit房間的通信。
• 🗣️ 兼容OpenAI：可與任何語音識別（STT）/文本轉語音（TTS）服務（本地或雲端）配合使用。
• ⚡ 實時交互：低延遲語音交互，自動選擇傳輸方式。
• 🔧 MCP集成：與Claude桌面端和其他MCP客戶端無縫集成。

📦 安裝指南

簡單要求

你只需要準備好以下兩樣東西即可開始使用：

1. 🔑 OpenAI API密鑰（或兼容服務）：用於語音識別和文本轉語音。
2. 🎤 配備麥克風和揚聲器的計算機 或者 ☁️ LiveKit服務器（LiveKit雲服務 或 自託管）

💻 使用示例

基礎用法

配置完成後，你可以向Claude嘗試以下提示：

• "讓我們進行語音對話"
• "用語音詢問我的一天"
• "給我講個笑話"（Claude會說話並等待你的回應）
• "說再見"（Claude會說話但不等待回應）

新的 converse 函數讓語音交互更加自然，默認情況下它會自動等待你的回應。

📚 詳細文檔

工具

配置

必需配置

export OPENAI_API_KEY="your-key"

可選配置

# 自定義服務（兼容OpenAI）
export STT_BASE_URL="http://localhost:2022/v1"  # 本地Whisper
export TTS_BASE_URL="http://localhost:8880/v1"  # 本地TTS
export TTS_VOICE="af_sky"                       # 天空語音（Kokoro）
export TTS_MODEL="tts-1"
export STT_MODEL="whisper-1"

# LiveKit（用於基於房間的通信）
export LIVEKIT_URL="wss://your-app.livekit.cloud"
export LIVEKIT_API_KEY="your-api-key"
export LIVEKIT_API_SECRET="your-api-secret"

# 調試
export VOICE_MCP_DEBUG="true"

故障排除

• 沒有麥克風：檢查系統權限。
• 未找到UV：運行 curl -LsSf https://astral.sh/uv/install.sh | sh。
• API錯誤：驗證 OPENAI_API_KEY。
• 調試模式：設置 VOICE_MCP_DEBUG=true（將音頻保存到 ~/voice-mcp_recordings/）。

📄 許可證

本項目採用MIT許可證。