voicevox-cli

![CI](https://github.com/r4ai/voicevox-cli/actions/workflows/ci.yml) ![Publish](https://github.com/r4ai/voicevox-cli/actions/workflows/publish.yml) ](https://www.npmjs.com/package/@r4ai/voicevox-cli) ](https://www.npmjs.com/package/@r4ai/voicevox-cli)

VOICEVOX 的CLI工具和MCP服务器。

必要环境

Node.js 24+
voicex引擎

\[！重要\] 要使用本CLI，VOICEVOX ENGINE http://localhost:50021 中所述修改相应参数的值。 URL"感染或游泳； --host 可选择更改。如何在Docker上启动：

安装

# npm
npm install -g @r4ai/voicevox-cli

# pnpm
pnpm add -g @r4ai/voicevox-cli

无需安装即可使用：

# npm
npx @r4ai/voicevox-cli

# pnpm
pnpx @r4ai/voicevox-cli

命令行界面

`voicevox speak`

将文本语音合成并保存到WAV文件中。

voicevox speak "こんにちは"
voicevox speak "こんにちは" --speaker 3 --output hello.wav
voicevox speak "こんにちは" --play                          # 合成後に再生
voicevox speak "こんにちは" --morph-target 3               # スピーカー 1 と 3 をモーフィング
voicevox speak "こんにちは" --morph-target 3 --morph-rate 0.8

可选｜缩写｜默认｜说明｜ | ---------------- | ------ | ------------------------ | ------------------------------------------------ | | --speaker | -s | 1 扬声器ID | --preset ｜预设ID（--speaker 优先）｜ | --output | -o | output.wav 输出文件路径 | --host | | http://localhost:50021 VOICEVOX ENGINE的URL | --play | -p | false 合成后播放 | --morph-target ｜变形目标扬声器ID｜ | --morph-rate | | 0.5 变形率（0.0=基础，1.0=目标）

`voicevox speakers`

显示可用扬声器的列表。

voicevox speakers
voicevox speakers --json        # JSON で出力
voicevox speakers --info        # バージョン・モーフィング対応・スタイル種別も表示

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ------------------------------------------------ | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出 | --info | false ｜显示版本、变形对应、样式类别｜

`voicevox singers`

显示歌唱用角色的一览表。

voicevox singers
voicevox singers --json   # JSON で出力

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出

`voicevox speaker-info`

显示扬声器的详细信息（使用策略图标和音频示例）。

voicevox speaker-info 
voicevox speaker-info  --json   # JSON で出力

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出

`voicevox initialize-speaker`

将扬声器的音频模型导入内存。在合成前使用未初始化扬声器时调用。

voicevox initialize-speaker 1
voicevox initialize-speaker 1 --skip-reinit   # 初期化済みならスキップ

｜选项｜默认｜说明｜ | --------------- | ------------------------ | ------------------------------------ | | --skip-reinit | false 如果已初始化，则跳过重新初始化 | --host | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox is-initialized-speaker`

确定扬声器是否已初始化。

voicevox is-initialized-speaker 1   # true または false を出力

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox query`

显示文本的审计队列JSON。

voicevox query "こんにちは"
voicevox query "こんにちは" --speaker 3

可选｜缩写｜默认｜说明｜ | ----------- | ------ | ------------------------ | ---------------------- | | --speaker | -s | 1 扬声器ID | --host | | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox accent-phrases`

显示文本重音子句JSON。audio_query 中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。

voicevox accent-phrases "こんにちは"
voicevox accent-phrases "こんにちは" --speaker 3
voicevox accent-phrases "コンニチワ" --is-kana

可选｜缩写｜默认｜说明｜ | ----------- | ------ | ------------------------ | ---------------------- | | --speaker | -s | 1 扬声器ID | --is-kana | | false 文本是否为假名 | --host | | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox dict`

管理用户词典。

voicevox dict                          # 辞書の一覧を表示
voicevox dict --json                   # JSON で出力
voicevox dict add       # 単語を追加
voicevox dict update  [options]  # 単語を更新
voicevox dict delete             # 単語を削除
voicevox dict export        # JSON ファイルにエクスポート
voicevox dict import        # JSON ファイルからインポート

`voicevox dict add

可选｜缩写｜默认｜说明｜ | --------------- | ------ | ------------------------ | ---------------------------------------------------------------------- | | --accent-type | -a | 0 ｜重音型｜ | --word-type | -t | COMMON_NOUN |品词（PROPER_NOUN / COMMON_NOUN / VERB / ADJECTIVE / SUFFIX) | | --priority | -p | 5 |优先度（0–10）| | --host | | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox dict update`

可选｜缩写｜说明｜ | ----------------- | ------ | ---------------------- | | --surface | -s |表层形| | --pronunciation | -r 读（片假名） | --accent-type | -a ｜重音型｜ | --word-type | -t |品词| | --priority | -p |优先度（0–10）| | --host VOICEVOX ENGINE的URL

`voicevox dict export`

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --indent | 2 ｜JSON缩进宽度｜ | --host | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox dict import`

可选｜缩写｜默认｜说明｜ | ------------ | ------ | ------------------------ | ---------------------- | | --override | -f | false 覆盖现有条目 | --host | | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox presets`

管理预设。

voicevox presets                    # プリセット一覧を表示
voicevox presets --json             # JSON で出力
voicevox presets add --name  --speaker-uuid  [options]
voicevox presets update  [options]
voicevox presets delete

`voicevox presets add`

可选｜缩写｜默认｜说明｜ | ----------------------- | ------ | ------------------------ | ----------------------- | | --name | -n 预设名称（必需） | --speaker-uuid | -u 扬声器UUID（必需） | --style-id | -s | 0 ｜样式ID｜ | --speed | | 1.0 |话速| | --pitch | | 0.0 | 音高 | | --intonation | | 1.0 |抑扬| | --volume | | 1.0 | 音量 | | --pre-phoneme-length | | 0.1 |开始无音时间| | --post-phoneme-length | | 0.1 |终了无音时间| | --host | | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox presets update`

可选｜缩写｜说明｜ | ----------------------- | ------ | ---------------------- | | --name | -n 预设名称 | --speaker-uuid | -u 扬声器UUID | --style-id | -s ｜样式ID｜ | --speed | |话速| | --pitch | | 音高 | | --intonation | |抑扬| | --volume | | 音量 | | --pre-phoneme-length | |开始无音时间| | --post-phoneme-length | |终了无音时间| | --host VOICEVOX ENGINE的URL

`voicevox validate-kana`

验证文本是否遵循AquesTalk风符号。

voicevox validate-kana "コンニチワ"

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox morphable-targets`

从引擎中获取扬声器列表，显示各样式的变形可否。

voicevox morphable-targets
voicevox morphable-targets --json   # JSON で出力

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出

`voicevox version`

显示引擎版本和核心版本。

voicevox version
voicevox version --host http://localhost:50021

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL

`voicevox info`

显示引擎清单和对应设备信息。

voicevox info
voicevox info --json   # JSON で出力

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出

`voicevox setting`

查看和更新引擎设置。

voicevox setting                                      # 現在の設定を表示
voicevox setting --json                               # JSON で出力
voicevox setting set --cors-policy-mode all           # CORS ポリシーを変更
voicevox setting set --allow-origin http://localhost  # 許可 Origin を設定
voicevox setting set --allow-origin ""                # 許可 Origin をクリア

｜选项｜默认｜说明｜ | ---------- | ------------------------ | ---------------------- | | --host | http://localhost:50021 VOICEVOX ENGINE的URL | --json | false 用JSON输出

`voicevox setting set`

｜选项｜说明｜ | -------------------- | ---------------------------------------- | | --cors-policy-mode ｜CORS策略模式： localapps / all | | --allow-origin ｜允许的Origin（用空字符串清除）｜ | --host VOICEVOX ENGINE的URL

`voicevox mcp`

以stdio模式启动MCP服务器。

voicevox mcp
voicevox mcp --host http://localhost:50021

`voicevox complete`

生成壳完成脚本。支持的壳： bash / zsh / fish / powershell

voicevox complete bash
voicevox complete zsh
voicevox complete fish
voicevox complete powershell

安装，安装

Bash

# 現在のセッションで有効化
source > ~/.bashrc

原有的质量

# 現在のセッションで有効化
source > ~/.zshrc

鱼

voicevox complete fish > ~/.config/fish/completions/voicevox.fish

PowerShell

# $PROFILE に追記して永続化
voicevox complete powershell >> $PROFILE

了解更多信息 @武装/插件完成来修改标记元素的显示属性。

MCP服务器

voicevox mcp 启动MCP服务器后，可以使用以下工具。

工具名称｜说明｜ | -------------------------------- | ---------------------------------------------------------------------------------------------------- | | list_speakers 返回可用扬声器列表（include_supported_features 在中追加取得变形许可信息）｜ | get_speaker_info | sections 在中指定检索范围来检索扬声器信息（默认：策略和样式图标） | initialize_speaker 将扬声器的声音模型导入内存 | is_initialized_speaker 确认扬声器是否已初始化 | audio_query 返回文本的AudioQuery JSON | synthesize 将文本进行语音合成，保存WAV文件并返回路径 | get_accent_phrases 从文本中获取重音子句 | get_mora_data 从重音句中取得音素的长度和音高 | get_mora_length 从重音句中取得音素的长度 | get_mora_pitch 从重音短语中获取音高 | get_user_dict 返回用户词典中的单词（search / word_type 中，单击limit / offset 页面对齐） | export_user_dict ｜将整个用户词典 import_user_dict 中选择另一种天花板类型 | add_user_dict_word 在用户词典中添加单词 | update_user_dict_word 更新用户词典中的单词 | delete_user_dict_word 删除用户词典中的单词 | list_presets 返回预设列表 | create_audio_query_from_preset 使用预设创建AudioQuery | validate_kana 验证AquesTalk风格的表记是否正确 | get_morphable_targets 从指定样式获取可变形样式ID的列表 | get_engine_info 获取引擎信息（版本、清单概要、对应设备）（icon、依存许可证等除外） | get_engine_licenses 获取引擎从属库的许可列表 | get_engine_update_history 获取引擎更新历史记录 | get_setting 获取引擎设置 | update_setting 更新引擎设置 | list_singers 返回歌唱用角色的一览表（include_supported_features 在中追加取得变形许可信息）｜ | sing 从乐谱数据中合成歌唱声音，保存WAV文件，返回路径 | multi_synthesize 将多个文本统一语音合成，保存ZIP文件，返回路径 | synthesis_morphing 将在两种样式之间变形的声音合成，保存WAV文件 | connect_waves 将多个WAV文件组合起来保存一个WAV文件并返回路径 | cancellable_synthesize 在可取消的合成端点语音合成文本并保存WAV文件

Claude Code的设置示例

.mcp.json 将条目添加到文档注册表。

{
  "mcpServers": {
    "voicevox": {
      "command": "npx",
      "args": ["@r4ai/voicevox-cli", "mcp"]
    }
  }
}

Claude Desktop的设置示例

claude_desktop_config.json 将条目添加到文档注册表。

{
  "mcpServers": {
    "voicevox": {
      "command": "npx",
      "args": ["@r4ai/voicevox-cli", "mcp"]
    }
  }
}

开発

.tool-versions 使用时 asdf install 或 mise install 中描述的相应参数的值。

pnpm install
pnpm build

pnpm dev        # ウォッチモードでビルド
pnpm build      # ビルド
pnpm typecheck  # 型チェック
pnpm test       # ユニットテストを実行

要运行E2E测试，必须启动VOICEVOX ENGINE。

VOICEVOX_HOST=http://localhost:50021 pnpm test:e2e

Voicevox CLI

快速接入

详细介绍

voicevox-cli

必要环境

安装

命令行界面

voicevox speak

voicevox speakers

voicevox singers

voicevox speaker-info

voicevox initialize-speaker

voicevox is-initialized-speaker

voicevox query

voicevox accent-phrases

voicevox dict

`voicevox dict add

voicevox dict update

voicevox dict export

voicevox dict import

voicevox presets

voicevox presets add

voicevox presets update

voicevox validate-kana

voicevox morphable-targets

voicevox version

voicevox info

voicevox setting

voicevox setting set

voicevox mcp

voicevox complete

安装，安装

MCP服务器

Claude Code的设置示例

Claude Desktop的设置示例

开発

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP

`voicevox speak`

`voicevox speakers`

`voicevox singers`

`voicevox speaker-info`

`voicevox initialize-speaker`

`voicevox is-initialized-speaker`

`voicevox query`

`voicevox accent-phrases`

`voicevox dict`

`voicevox dict update`

`voicevox dict export`

`voicevox dict import`

`voicevox presets`

`voicevox presets add`

`voicevox presets update`

`voicevox validate-kana`

`voicevox morphable-targets`

`voicevox version`

`voicevox info`

`voicevox setting`

`voicevox setting set`

`voicevox mcp`

`voicevox complete`