# 安装 dev.voicemode/voicemode

- 类型: MCP 工具
- 说明: 通过 MCP 提供语音转文字与文字转语音能力，帮助 AI 助手进行自然语音对话。
- 仓库: https://github.com/mbailey/voicemode

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "dev.voicemode/voicemode" MCP 服务：
执行：claude mcp add 'dev-voicemode-voicemode' -- npx -y voice-mode
```

### Codex
```
请帮我安装 askskill 上的 "dev.voicemode/voicemode" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.dev-voicemode-voicemode]
command = "npx"
args = ["-y","voice-mode"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "dev.voicemode/voicemode" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"dev-voicemode-voicemode": { "command": "npx", "args": ["-y","voice-mode"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env OPENAI_API_KEY=YOUR_VALUE --env VOICEMODE_DEBUG=YOUR_VALUE --env VOICEMODE_SKIP_TTS=YOUR_VALUE --env VOICEMODE_PREFER_LOCAL=YOUR_VALUE --env VOICEMODE_AUDIO_FORMAT=YOUR_VALUE --env VOICEMODE_WHISPER_MODEL=YOUR_VALUE --env VOICEMODE_DISABLE_SILENCE_DETECTION=YOUR_VALUE --transport stdio dev-voicemode-voicemode -- npx -y voice-mode
```
需要环境变量：OPENAI_API_KEY, VOICEMODE_DEBUG, VOICEMODE_SKIP_TTS, VOICEMODE_PREFER_LOCAL, VOICEMODE_AUDIO_FORMAT, VOICEMODE_WHISPER_MODEL, VOICEMODE_DISABLE_SILENCE_DETECTION

### Codex
```bash
codex mcp add --env OPENAI_API_KEY=YOUR_VALUE --env VOICEMODE_DEBUG=YOUR_VALUE --env VOICEMODE_SKIP_TTS=YOUR_VALUE --env VOICEMODE_PREFER_LOCAL=YOUR_VALUE --env VOICEMODE_AUDIO_FORMAT=YOUR_VALUE --env VOICEMODE_WHISPER_MODEL=YOUR_VALUE --env VOICEMODE_DISABLE_SILENCE_DETECTION=YOUR_VALUE dev-voicemode-voicemode -- npx -y voice-mode
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.dev-voicemode-voicemode]
command = "npx"
args = ["-y","voice-mode"]

[mcp_servers.dev-voicemode-voicemode.env]
OPENAI_API_KEY = "YOUR_VALUE"
VOICEMODE_DEBUG = "YOUR_VALUE"
VOICEMODE_SKIP_TTS = "YOUR_VALUE"
VOICEMODE_PREFER_LOCAL = "YOUR_VALUE"
VOICEMODE_AUDIO_FORMAT = "YOUR_VALUE"
VOICEMODE_WHISPER_MODEL = "YOUR_VALUE"
VOICEMODE_DISABLE_SILENCE_DETECTION = "YOUR_VALUE"
```
需要环境变量：OPENAI_API_KEY, VOICEMODE_DEBUG, VOICEMODE_SKIP_TTS, VOICEMODE_PREFER_LOCAL, VOICEMODE_AUDIO_FORMAT, VOICEMODE_WHISPER_MODEL, VOICEMODE_DISABLE_SILENCE_DETECTION

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "dev-voicemode-voicemode": {
      "command": "npx",
      "args": [
        "-y",
        "voice-mode"
      ],
      "env": {
        "OPENAI_API_KEY": "YOUR_VALUE",
        "VOICEMODE_DEBUG": "YOUR_VALUE",
        "VOICEMODE_SKIP_TTS": "YOUR_VALUE",
        "VOICEMODE_PREFER_LOCAL": "YOUR_VALUE",
        "VOICEMODE_AUDIO_FORMAT": "YOUR_VALUE",
        "VOICEMODE_WHISPER_MODEL": "YOUR_VALUE",
        "VOICEMODE_DISABLE_SILENCE_DETECTION": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=dev-voicemode-voicemode&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInZvaWNlLW1vZGUiXSwiZW52Ijp7Ik9QRU5BSV9BUElfS0VZIjoiWU9VUl9WQUxVRSIsIlZPSUNFTU9ERV9ERUJVRyI6IllPVVJfVkFMVUUiLCJWT0lDRU1PREVfU0tJUF9UVFMiOiJZT1VSX1ZBTFVFIiwiVk9JQ0VNT0RFX1BSRUZFUl9MT0NBTCI6IllPVVJfVkFMVUUiLCJWT0lDRU1PREVfQVVESU9fRk9STUFUIjoiWU9VUl9WQUxVRSIsIlZPSUNFTU9ERV9XSElTUEVSX01PREVMIjoiWU9VUl9WQUxVRSIsIlZPSUNFTU9ERV9ESVNBQkxFX1NJTEVOQ0VfREVURUNUSU9OIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：OPENAI_API_KEY, VOICEMODE_DEBUG, VOICEMODE_SKIP_TTS, VOICEMODE_PREFER_LOCAL, VOICEMODE_AUDIO_FORMAT, VOICEMODE_WHISPER_MODEL, VOICEMODE_DISABLE_SILENCE_DETECTION