MCP Tts Voicevox

🚀 VOICEVOXを使用したMCP TTS音声合成サーバー

このサーバーは、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();

基本的な使用法

上記のコードは、VoicevoxClientを使用して音声合成を行う基本的な例です。

高度な使用法

// 高度なシナリオの説明：特定の話者や速度を指定して音声合成を行うことができます。
const client = new VoicevoxClient({
  url: "http://localhost:50021",
  defaultSpeaker: 2,
  defaultSpeedScale: 1.2
});
await client.speak("こんばんは");

📚 ドキュメント

主要機能

• テキスト読み上げ (speak) - テキストを音声に変換して再生します。
• クエリ生成 (generate_query) - 音声合成用のクエリを作成します。
• ファイル生成 (synthesize_file) - クエリから音声ファイルを生成します。
• キュークリア (clear_queue) - 現在のすべての音声合成タスクをクリアします。

環境変数

📄 ライセンス

ISC