voicepeak

This MCP server provides an interface to VOICEPEAK's text-to-speech capabilities. It exposes a set of tools for generating and playing speech from text, managing narrators and emotions, and handling pronunciation dictionaries. Core tools include synthesize to generate speech files from text (up to 140 characters), synthesize_and_play to generate and immediately play back speech, and play to playback existing audio files. You can also query available narrators with list_narrators and available emotions with list_emotions, as well as inspect and manage the pronunciation dictionaries using dictionary_list, dictionary_add, dictionary_remove, dictionary_find, and dictionary_clear. Note that some dictionary features are not available on Windows systems, and you may need to manage dictionaries directly from the VOICEPEAK application on Windows.

To use these tools, point your MCP client (or Claude Desktop integration) at the voicepeak MCP server and call the corresponding tool with the required parameters. For example, synthesize requires text input, and you can optionally specify narrators, emotion, speed, pitch, and an output path. The server ensures VoicePeak is installed on the host and uses NPX (as configured) to run the VoicePeak MCP package.

Prerequisites:

• VOICEPEAK must be installed on the host machine.
• Node.js and NPX are available (NPX usage is recommended).

Installation steps:

1. Install via NPX (recommended):

npx voicepeak-mcp@latest

2. Alternative: use Bunx (if you prefer Bun-based workflow):

bunx voicepeak-mcp

3. Verify installation by starting the MCP server and ensuring VOICEPEAK is accessible. If needed, adjust PATH or VOICEPEAK installation paths so the server can invoke VOICEPEAK components.

Configuration example for Claude Desktop:

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

Tips:

• The server supports a maximum of 140 characters for synthesis in the synthesize tool. If longer input is needed, consider splitting into chunks.
• Some dictionary-related features are not available on Windows; manage dictionaries using the VOICEPEAK application on Windows.
• Ensure VOICEPEAK is properly installed and accessible on the host where the MCP server runs. If you encounter permission issues, run with appropriate user privileges.
• When configuring in Claude Desktop, you may specify the server under mcpServers with the command and arguments shown in the installation/configuration example.

Common issues:

• NPX not found: ensure Node.js and NPX are installed and accessible in your PATH.
• VOICEPEAK not found: verify VOICEPEAK installation path and that the MCP server can invoke VOICEPEAK binaries.
• Platform limitations: dictionary features are limited on Windows; consider using VOICEPEAK app for dictionary management.