Voicemode MCP

语音模式

与Claude Code（和其他支持MCP的代理）进行自然语音对话

](https://pepy.tech/project/voice-mode) ](https://pepy.tech/project/voice-mode) ](https://pepy.tech/project/voice-mode)

VoiceMode允许与Claude Code进行自然的语音对话。语音不是要取代打字，而是要在打字不可用时提供帮助。

非常适合：

• 步行去参加下一次会议
• 调试时烹饪
• 在数小时的屏幕时间后让你的眼睛休息一下
• 拿着咖啡（或狗）
• 当你的手或眼睛忙碌的时候

在行动中看到它


快速开始

要求： 带麦克风和扬声器的电脑

选项1:克劳德代码插件（推荐）

Claude Code用户入门的最快方法：

# Add the VoiceMode marketplace
claude plugin marketplace add mbailey/voicemode

# Install VoiceMode plugin
claude plugin install voicemode@voicemode

## Install dependencies (CLI, Local Voice Services)

/voicemode:install

# Start talking!
/voicemode:converse

选项2:Python安装包

安装依赖项和VoiceMode Python包。

# Install UV package manager (if needed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the installer (sets up dependencies and local voice services)
uvx voice-mode-install

# Add to Claude Code
claude mcp add --scope user voicemode -- uvx --refresh voice-mode

# Optional: Add OpenAI API key as fallback for local services
export OPENAI_API_KEY=your-openai-key

# Start a conversation
claude converse

有关手动设置，请参阅 入门指南.

特性

• 自然对话 -说话自然，立即听到回应
• 离线工作 -可选的本地语音服务（Whisper STT、Kokoro TTS）
• 低延迟 -足够快，感觉像是一场真正的对话
• 智能静音检测 -当你停止说话时停止录音
• 隐私选项 -完全在本地运行或使用云服务

兼容性

平台： Linux、macOS、Windows（WSL）、NixOS python 3.10-3.14

配置

VoiceMode开箱即用。自定义：

# Set OpenAI API key (if using cloud services)
export OPENAI_API_KEY="your-key"

# Or configure via file
voicemode config edit

请参阅 配置指南 对于所有选项。

权限设置（可选）

要在没有权限提示的情况下使用VoiceMode，请添加到 ~/.claude/settings.json:

{
  "permissions": {
    "allow": [
      "mcp__voicemode__converse",
      "mcp__voicemode__service"
    ]
  }
}

请参阅 权限指南 更多选择。

本地语音服务

为了保护隐私或离线使用，请安装本地语音服务：

• Whisper.cpp -本地语音转文本
• 心 -具有多种语音的本地文本转语音

它们提供与OpenAI相同的API，因此VoiceMode在它们之间无缝切换。

安装细节

System Dependencies by Platform

Ubuntu/Debian

sudo apt update
sudo apt install -y ffmpeg gcc libasound2-dev libasound2-plugins libportaudio2 portaudio19-dev pulseaudio pulseaudio-utils python3-dev

WSL2用户：麦克风访问需要上述脉冲音频包。

Fedora/RHEL

sudo dnf install alsa-lib-devel ffmpeg gcc portaudio portaudio-devel python3-devel

macOS

brew install ffmpeg node portaudio

NixOS 系统

# Use development shell
nix develop github:mbailey/voicemode

# Or install system-wide
nix profile install github:mbailey/voicemode

Alternative Installation Methods

来源

git clone https://github.com/mbailey/voicemode.git
cd voicemode
uv tool install -e .

NixOS系统范围

# In /etc/nixos/configuration.nix
environment.systemPackages = [
  (builtins.getFlake "github:mbailey/voicemode").packages.${pkgs.system}.default
];

故障排除

保存音频以进行调试

export VOICEMODE_SAVE_AUDIO=true
# Files saved to ~/.voicemode/audio/YYYY/MM/

文档

• 入门指南 -完整设置指南
• 配置 -所有环境变量
• Whisper设置 -本地语音转文本
• Kokoro设置 -本地文本转语音
• 开发设置 -贡献指南

完整文档： voice-mode.readdocs.io

链接

• 网站: getvoicemode.com
• GitHub:
• PyPI: pypi.org/project/voice-mode
• 油管: @getvoicemode
• 推特/X: @getvoicemode
• 通讯: 

许可证

麻省理工学院-A 文件模式 项目

______________________________________________________________________

mcp名称：com.failmode/voicemode