关于 voicemode-connect
voicemode-connect 是用于 AI 助手与 voicemode.dev 云平台进行语音对话的技能。Claude Code 或 claude.ai 通过 MCP 接入,iOS 和网页客户端承载语音,无需本地 STT/TTS 服务。
主要功能
- 01查看已连接的设备和 Agent
- 02进行双向语音对话
- 03使用 iOS 和网页语音客户端
- 04通过 voicemode.dev 转发语音消息
适用场景
- 01通过 iOS 应用与助手交谈
- 02使用浏览器进行语音对话
- 03无需本地 STT/TTS 即可添加移动语音
MCP 相关
该技能通过 MCP 将 Claude Code 或 claude.ai 接入 voicemode.dev。`status` 和 `converse` 工具用于查看连接状态,并通过已连接的客户端进行语音对话。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ mbailey/ voicemode --skill voicemode-connect安装后在 Claude Code 中输入/voicemode-connect确认已加载。
详细介绍
VoiceMode Connect
通过 voicemode.dev 云平台进行语音对话。将 AI 助手连接到语音客户端(iOS 应用、Web 应用),无需运行本地 STT/TTS 服务。
工作原理
Agent(Claude Code、claude.ai)通过 MCP 连接到 voicemode.dev。 客户端(iOS 应用、Web 应用)通过 WebSocket 连接。 该平台负责在它们之间路由语音消息。
快速设置
1. 添加 MCP 服务
将其添加到 Claude Code MCP 设置中(~/.claude/settings.json):
{
"mcpServers": {
"voicemode-dev": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://voicemode.dev/mcp"]
}
}
}
2. 进行身份验证
首次使用 Connect 工具时,Claude Code 会提示进行 OAuth 身份验证。使用你的 voicemode.dev 账户登录。
3. 连接客户端
打开 iOS 应用或 Web 控制面板(voicemode.dev/dashboard),并使用同一账户登录。
4. 开始对话
使用 status 工具查看已连接的设备,然后使用 converse 进行语音对话。
MCP 工具
| 工具 | 描述 |
|---|---|
status | 显示已连接的设备和 Agent |
converse | 通过已连接的客户端进行双向语音对话 |
与本地 VoiceMode 的关系
| 功能 | 本地 VoiceMode | VoiceMode Connect |
|---|---|---|
| STT/TTS | 本地(Whisper/Kokoro) | 客户端设备(手机/浏览器) |
| 设置 | 安装服务 | 只需添加 MCP 服务 |
| 互联网 | 可选 | 必需 |
| 延迟 | 较低 | 较高 |
| 移动语音 | 否 | 是 |
两者都用:使用本地 VoiceMode 进行桌面语音交互,使用 Connect 进行移动语音交互。
文档
- 概览 - 什么是 VoiceMode Connect
- 架构 - Agent 和客户端如何连接
- Claude Code 设置 - 详细设置指南
- MCP 工具参考 - 工具参数
待解决问题
- 同一账户上的多个 Agent 如何交互?
- 连接多个客户端时会发生什么?
- 如何为
converse选择目标设备?
随着了解的深入,我们会将这些问题记录在 docs/connect/ 中。