voicemode — MCP-сервер для Claude Code: голосовой ввод и установка
voicemode даёт общаться с ИИ-агентом голосом: распознаёт речь и озвучивает ответы. Пригодится, когда руки заняты или хочется отдохнуть от экрана.
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env VOICEMODE_DEBUG=<VOICEMODE_DEBUG> --env VOICEMODE_SKIP_TTS=<VOICEMODE_SKIP_TTS> --env VOICEMODE_PREFER_LOCAL=<VOICEMODE_PREFER_LOCAL> --env VOICEMODE_AUDIO_FORMAT=<VOICEMODE_AUDIO_FORMAT> --transport stdio voicemode -- uvx voice-modeЧто делает voicemode
Сервер связывает голосовой ввод и озвучивание ответов агента. Он использует распознавание речи и синтез речи; для локальной работы можно установить Whisper.cpp и Kokoro. Локальные службы речи поддерживают тот же API, что и OpenAI.
Для работы понадобятся компьютер с микрофоном и динамиками. При использовании облачных служб задайте OPENAI_API_KEY; для локального режима ключ OpenAI не требуется. В README указана поддержка Python 3.10–3.14 и платформ Linux, macOS, Windows, WSL и NixOS. Если микрофон не доступен в WSL2, нужны пакеты PulseAudio.
Какие задачи решает
- надиктовать запрос агенту, когда руки заняты
- получить голосовой ответ вместо чтения с экрана
- обрабатывать речь локально с Whisper.cpp
- озвучивать ответы локально через Kokoro
Примеры запросов агенту
- Обсуди со мной голосом план изменений в проекте.
- Выслушай моё описание ошибки и предложи, как её исправить.
- Отвечай голосом, используя локальные службы речи.
Как установить voicemode
Командой платформы
claude mcp add --env OPENAI_API_KEY=<OPENAI_API_KEY> --env VOICEMODE_DEBUG=<VOICEMODE_DEBUG> --env VOICEMODE_SKIP_TTS=<VOICEMODE_SKIP_TTS> --env VOICEMODE_PREFER_LOCAL=<VOICEMODE_PREFER_LOCAL> --env VOICEMODE_AUDIO_FORMAT=<VOICEMODE_AUDIO_FORMAT> --transport stdio voicemode -- uvx voice-modeВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from voice-mode <команда>
Командой платформы
codex mcp add voicemode --env OPENAI_API_KEY=<OPENAI_API_KEY> --env VOICEMODE_DEBUG=<VOICEMODE_DEBUG> --env VOICEMODE_SKIP_TTS=<VOICEMODE_SKIP_TTS> --env VOICEMODE_PREFER_LOCAL=<VOICEMODE_PREFER_LOCAL> --env VOICEMODE_AUDIO_FORMAT=<VOICEMODE_AUDIO_FORMAT> -- uvx voice-modeВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from voice-mode <команда>
Файл настроек
{
"mcpServers": {
"voicemode": {
"command": "uvx",
"args": [
"voice-mode"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"VOICEMODE_DEBUG": "<VOICEMODE_DEBUG>",
"VOICEMODE_SKIP_TTS": "<VOICEMODE_SKIP_TTS>",
"VOICEMODE_PREFER_LOCAL": "<VOICEMODE_PREFER_LOCAL>",
"VOICEMODE_AUDIO_FORMAT": "<VOICEMODE_AUDIO_FORMAT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from voice-mode <команда>
Файл настроек
{
"servers": {
"voicemode": {
"type": "stdio",
"command": "uvx",
"args": [
"voice-mode"
],
"env": {
"OPENAI_API_KEY": "<OPENAI_API_KEY>",
"VOICEMODE_DEBUG": "<VOICEMODE_DEBUG>",
"VOICEMODE_SKIP_TTS": "<VOICEMODE_SKIP_TTS>",
"VOICEMODE_PREFER_LOCAL": "<VOICEMODE_PREFER_LOCAL>",
"VOICEMODE_AUDIO_FORMAT": "<VOICEMODE_AUDIO_FORMAT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from voice-mode <команда>
Командой платформы
gemini mcp add -e OPENAI_API_KEY=<OPENAI_API_KEY> -e VOICEMODE_DEBUG=<VOICEMODE_DEBUG> -e VOICEMODE_SKIP_TTS=<VOICEMODE_SKIP_TTS> -e VOICEMODE_PREFER_LOCAL=<VOICEMODE_PREFER_LOCAL> -e VOICEMODE_AUDIO_FORMAT=<VOICEMODE_AUDIO_FORMAT> voicemode uvx voice-modeВместо <…> подставьте свои значения. Ещё 2 переменные окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from voice-mode <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «Настройка агента: память, контекст, субагенты»
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Вопросы о voicemode
Как установить voicemode в Claude Code?
Выполните claude mcp add voicemode -e OPENAI_API_KEY=<OPENAI_API_KEY> -- uvx voice-mode. Для облачных служб укажите свой ключ вместо <OPENAI_API_KEY>.
Что делает voicemode?
Сервер позволяет говорить с ИИ-агентом и получать голосовые ответы. Он поддерживает распознавание и синтез речи.
Можно ли использовать voicemode офлайн?
Да. Для локального распознавания речи предусмотрен Whisper.cpp, а для синтеза — Kokoro. Локальные службы позволяют работать без облачной обработки речи.
