← 返回目录

VoiceMode

社区

与 Claude Code 及其他支持 MCP 的 AI 助手进行自然语音对话。

GitHub 源仓库 ↗

★ 1.3k Stars 分类 · 开发工具非常热门源版本 5c1b3e4d9421

56FMRS · C

可靠性

8/20

安全与权限

10/20

维护活跃度

12/20

文档质量

13/20

安装易用性

13/20

VoiceMode 是一个实用的 MCP 服务器，为 Claude Code 增添了自然的语音交互能力。它同时支持云端和本地语音处理，并带有静音检测等合理默认设置。安装过程简单，适合免提编码场景。隐私敏感用户应注意云端服务会发送音频，而本地模型则需较高系统资源。总体上是成熟且活跃的开源项目。

查看 FMRS 评分方法 →

VoiceMode 是一个 MCP 服务器，通过语音转文字（STT）和文字转语音（TTS）让用户与 Claude Code 等 AI 代理进行自然的语音对话。它兼顾本地（Whisper、Kokoro）和云端语音服务，具备低延迟与智能静音检测，适合双手或双眼忙碌的场合。

工具能力

converse

与 AI 助手进行自然的语音对话。

service

管理 VoiceMode 语音服务。

安装接入

如需要，安装 UV 包管理器：curl -LsSf https://astral.sh/uv/install.sh | sh
运行安装程序：uvx voice-mode-install
添加到 Claude Code：claude mcp add --scope user voicemode -- uvx --refresh --from voice-mode voicemode-mcp-launcher
可选：设置 OPENAI_API_KEY 以使用云端服务。
开始对话：claude converse

claude_desktop_config.json

{
  "mcpServers": {
    "voicemode": {
      "command": "uvx",
      "args": ["--refresh", "--from", "voice-mode", "voicemode-mcp-launcher"]
    }
  }
}

生成并校验客户端配置

选型与风险

适合谁

希望与编程助手语音交流的 Claude Code 用户
需要在任务中免提操作的开发者
偏好本地、隐私语音处理的用户

不适合谁

没有麦克风或扬声器的用户
完全纯文本、无法播放音频的环境

所需权限

访问麦克风以捕获语音输入
使用扬声器或音频输出设备播放回复
使用云端 STT/TTS 服务（如 OpenAI）时需要网络访问
Claude Code 中 converse 和 service 工具的 MCP 权限

风险与副作用

启用云端语音服务时，音频会传输到第三方服务器（如 OpenAI）
本地语音模型（Whisper、Kokoro）可能占用较多计算资源
麦克风权限意味着 MCP 进程会捕获环境声音

常见排障

无法访问麦克风：检查终端或应用权限；WSL2 用户需要安装 pulseaudio 相关软件包。
找不到 UV：运行 curl -LsSf https://astral.sh/uv/install.sh | sh。
OpenAI API 错误：确认 OPENAI_API_KEY 设置正确。
没有音频输出：检查系统音频设置和可用设备。

使用场景

一边走路去开会一边继续工作

一边做饭一边调试代码

长时间看屏幕后让眼睛休息

一手拿咖啡或遛狗时编码

无法打字时的免提操作

支持客户端

Claude Code完整支持