VoicePeak MCP 服务器
是通过模型上下文协议（MCP）提供VOICEPEAK功能的服务器。
概要
此MCP服务器使得能够从支持MCP的AI助手（如Windsurf、Claude Desktop、Cursor等）中使用VOICEPEAK的命令行功能。
技术规格： 由于VOICEPEAK的命令行不直接支持音频播放，因此需先输出到临时WAV文件winsound采用了模块化播放方式。
功能
提供的工具
- 说出文字 - 将文本用语音朗读
- 指定文本后立即朗读 - 可自定义旁白、情感、语速和音调
- 生成语音 - 从文本生成音频文件
- 将文本保存为音频文件（.wav） - 可自定义旁白、情感、语速和音调
- 文本转语音 - 从文本文件生成音频文件
- 将文本文件的内容转换为音频文件 - 可自定义旁白、情感、语速和音调
- 朗读者列表 - 获取旁白列表
- 显示可用声音（旁白）列表
- 情绪列表 - 获取情感表现列表
- 显示所选朗读者可用的情感表达列表
快速启动
必要条件
- Python 3.10及以上版本
- 紫外线（Python包管理器）
- VOICEPEAK（已安装）
使用MCP客户端（推荐）
只需在您所使用的MCP客户端的设置文件中添加以下内容即可使用。
在风帆冲浪的情况下
{
"mcpServers": {
"voicepeak": {
"command": "uv",
"args": [
"run",
"--directory",
"C:/path/to/your/voicepeak-mcp-project",
"python",
"voicepeak_mcp_server.py"
],
"env": {
"VOICEPEAK_PATH": "C:\\Program Files\\VOICEPEAK\\voicepeak.exe"
}
}
}
}在Claude Desktop的情况下
{
"mcpServers": {
"voicepeak": {
"command": "uv",
"args": [
"run",
"--directory",
"C:/path/to/your/voicepeak-mcp-project",
"python",
"voicepeak_mcp_server.py"
],
"env": {
"VOICEPEAK_PATH": "C:\\Program Files\\VOICEPEAK\\voicepeak.exe"
}
}
}
}设定要点：
--directory更改此项目的克隆/部署路径VOICEPEAK_PATHVOICEPEAK的安装路径（默认设置无误则无需更改）
重启MCP客户端这样，马上就能用！
______________________________________________________________________
作为独立程序使用时（开发用）
1. 安装依赖项
Bash/PowerShell：（保持原样，因为这是技术术语，直接翻译无意义，可理解为“在Bash或PowerShell中”）
uv pip install -r requirements.txt命令提示符（cmd）：
uv pip install -r requirements.txt2. 设置环境变量（可选）
VOICEPEAK的安装路径为默认（C:\Program Files\VOICEPEAK\voicepeak.exe仅当与（）不同时设置：
命令提示符（cmd）：
set VOICEPEAK_PATH=C:\your\custom\path\voicepeak.exePowerShell：
$env:VOICEPEAK_PATH="C:\your\custom\path\voicepeak.exe"3. 启动服务器
Bash/PowerShell/cmd:（可翻译为）Bash/PowerShell/cmd（命令行界面）:
uv run python voicepeak_mcp_server.py服务器启动后，可通过MCP从其他终端或应用程序进行连接。
参数
公共参数
- 叙述者 （字符串，可省略）：旁白者名称（可通过--list-narrator确认）
- 情感 （字符串，可省略）：情感表现（例：“happy=50,sad=50”）
- 速度 (integer，可省略): 速度（50-200，默认: 100）
- 音高（或投球姿势，在棒球等运动中） （整数，可省略）：音高（-300-300，默认：0）
使用示例
可以通过MCP客户端（如Windsurf、Claude Desktop等）进行如下指示：
基本朗读
「こんにちは、世界」と読み上げてください指定旁白
重音テトの声で「こんにちは」と話してください指定情感表达
宮舞モカの声で、ほんわかした感じで「おはようございます」と言ってください生成音频文件
「テストメッセージです」というテキストを output.wav に保存してください获取旁白列表
利用可能なナレーターを教えてください确认情感表达
ずんだもんで使える感情表現を教えてください项目构成
voicepeak-mcp/
├── voicepeak_mcp_server.py # MCPサーバー本体
├── mcp_config_example.json # MCP設定サンプル
├── requirements.txt # Python依存パッケージ
├── pyproject.toml # プロジェクト設定（uv用）
├── .gitignore # Git除外設定
└── README.md # このファイル故障排除
无法连接到MCP服务器
- 重启MCP客户端请（做某事）
- 设置文件的
--directory确认密码是否正确
- 在终端执行以下操作，确认服务器是否启动：
Bash/PowerShell（注：Bash是Unix/Linux系统下的命令行解释器，PowerShell是微软开发的命令行shell和脚本语言）
cd "C:/path/to/your/voicepeak-mcp-project"
uv run python voicepeak_mcp_server.py命令提示符（cmd）:
cd C:\path\to\your\voicepeak-mcp-project
uv run python voicepeak_mcp_server.py找不到VOICEPEAK
如果VOICEPEAK的安装路径与默认路径不同，请在MCP客户端的设置文件中env.VOICEPEAK_PATH请修改：
"env": {
"VOICEPEAK_PATH": "C:\\your\\custom\\path\\voicepeak.exe"
}声音无法播放
- 确认VOICEPEAK是否已正确安装
- 确认Windows音量设置
- 确认VOICEPEAK的许可证是否有效
对应解说员
可使用VOICEPEAK中安装的朗读功能。例如：
- 东北阿呆 （东北冢子）
- Zundamon（一种日本搞笑虚拟主播） （祖达蒙）
- 东北kiritan （东北麒麟酱）
- 宫舞舞歌 （宫前桃佳）
- 重音Teto （Kasane Teto，通常译作“卡萨涅·天音”或“镜音铃”的声优/虚拟歌姬名，这里保留原名以体现特定文化背景）
各旁白员可使用的感情表现方式为list_emotions可以用工具进行确认。
技术栈
- Python 3.10+
- MCP（模型上下文协议） - 与AI协作的标准协议
- 紫外线 - Python包管理器
- VOICEPEAK（音译） - 语音合成引擎
许可证
该项目在MIT许可协议下公开。
注意事项
- VOICEPEAK需另行购买和安装
- 请遵循VOICEPEAK的许可条款使用VOICEPEAK
- 此MCP服务器仅适用于Windows系统（
winsound（使用模块）
贡献
请在GitHub的Issues上提交错误报告或功能增加的建议。