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 應用程序管理詞典。

🤝 貢獻

歡迎提交問題和拉取請求！