voicepeak-mcp

🚀 voicepeak-mcp

voicepeak-mcp 是为 VOICEPEAK 文本朗读功能提供的 MCP 服务器，可助力实现文本到语音的转换。

🚀 快速开始

在使用该服务器前，需要确保 VOICEPEAK 已安装。

📦 安装指南

使用 NPX（推荐）

npx voicepeak-mcp@latest

使用 Bunx

bunx voicepeak-mcp

💻 使用示例

配置

将以下内容添加到 Claude Desktop 的配置中：

{
  "mcpServers": {
    "voicepeak": {
      "command": "npx",
      "args": ["voicepeak-mcp@latest"]
    }
  }
}

可用工具

synthesize

从文本生成语音文件（最多 140 个字符）。

• 参数：
  • text（必需）：要合成的文本
  • narrator：叙述者名称
  • emotion：情感参数
  • speed：语速（50 - 200）
  • pitch：音调（-300 至 300）
  • outputPath：输出文件路径

synthesize_and_play

生成语音并立即播放（最多 140 个字符）。

play

播放语音文件。

list_narrators

列出可用的叙述者。

list_emotions

列出叙述者可用的情感。

dictionary_list

列出所有发音词典条目。

⚠️ 重要提示

词典功能在 Windows 上不可用。Windows 用户请在 VOICEPEAK 应用程序中管理发音词典。

dictionary_add

添加或更新自定义发音的词典条目。

• 参数：
  • surface（必需）：要替换的文本
  • pronunciation（必需）：日语假名发音
  • priority：优先级（0 - 10，默认值：5）

⚠️ 重要提示

此功能在 Windows 上不可用。

dictionary_remove

删除词典条目。

⚠️ 重要提示

此功能在 Windows 上不可用。

dictionary_find

按文本搜索词典条目。

⚠️ 重要提示

此功能在 Windows 上不可用。

dictionary_clear

清除所有词典条目。

⚠️ 重要提示

此功能在 Windows 上不可用。

📚 详细文档

支持的平台

• ✅ macOS（支持所有功能）
• ⚠️ Windows（部分支持：仅语音合成和播放，不支持词典功能）
• 🚧 Linux（计划中）

Windows 限制

在 Windows 版本中，发音词典管理功能（dictionary_*）不可用。如果需要自定义发音，请通过 VOICEPEAK 应用程序管理词典。

🤝 贡献

欢迎提交问题和拉取请求！