使用VOICEVOX的MCP TTS语音合成服务器

特性

• 队列管理功能 - 高效处理多个语音合成请求
• 预获取 - 提前生成下一个语音，实现平滑播放

先决条件

• Node.js
• VOICEVOX引擎

安装指南

npm install -g @kajidog/mcp-tts-voicevox

作为MCP服务器使用

1. 启动VOICEVOX引擎
2. 启动MCP服务器

npx @kajidog/mcp-tts-voicevox

项目中直接导入使用

npm install @kajidog/mcp-tts-voicevox

import { VoicevoxClient } from "@kajidog/mcp-tts-voicevox";

// 初始化客户端
const client = new VoicevoxClient({
  url: "http://localhost:50021", // VOICEVOX引擎的URL
  defaultSpeaker: 1,             // 默认发言人ID（可选）
  defaultSpeedScale: 1.0         // 默认速度（可选）
});

// 将文本转换为语音并播放
await client.speak("你好");

// 从文本生成语音文件
const filePath = await client.generateAudioFile("你好", "./output.wav");

// 清空队列
await client.clearQueue();

主要功能

• 文本朗读 (speak) - 将文本转换为语音并播放
• 查询生成 (generate_query) - 创建语音合成用的查询
• 文件生成 (synthesize_file) - 从查询生成语音文件
• 队列清理 (clear_queue) - 清除当前所有的语音合成任务

环境变量

• VOICEVOX_URL: VOICEVOX引擎的URL（默认: http://localhost:50021）
• VOICEVOX_DEFAULT_SPEAKER: 默认发言人ID（例如: 1）
• VOICEVOX_DEFAULT_SPEED_SCALE: 默认播放速度（例如: 1.0）

许可证

ISC