金大哥 - mcp-tts-voicevox MCP 详情

article

README

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

本项目是一个基于VOICEVOX的MCP TTS语音合成服务器，具备队列管理和预获取功能，能高效处理多个语音合成请求，实现语音的平滑播放。

🚀 快速开始

本项目可以作为MCP服务器使用，也可以在项目中直接导入使用。在使用前，需要确保你已经安装了Node.js和VOICEVOX引擎。

✨ 主要特性

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

📦 安装指南

全局安装本项目：

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

💻 使用示例

作为MCP服务器使用

启动VOICEVOX引擎
启动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

mcp-tts-voicevox