MCP Tts Voicevox

🚀 使用VOICEVOX的MCP TTS語音合成服務器

本項目是一個基於VOICEVOX的MCP TTS語音合成服務器，具備隊列管理和預獲取功能，能高效處理多個語音合成請求，實現語音的平滑播放。

🚀 快速開始

本項目可以作為MCP服務器使用，也可以在項目中直接導入使用。在使用前，需要確保你已經安裝了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) - 清除當前所有的語音合成任務

環境變量

📄 許可證

ISC