README

MCP TTS VOICEVOX

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

必要条件

Node.js
VOICEVOXエンジン

機能概要

テキストから音声を合成して再生
テキストから音声合成用クエリを生成
音声合成用クエリから音声ファイルを生成
テキストまたはクエリを音声生成キューに追加

使い方

インストール

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

実行

VOICEVOXエンジンを起動
以下のコマンドを実行

npx @kajidog/mcp-tts-voicevox

MCPツールとして使用

1. テキストを音声に変換して再生

await mcp.invoke("speak", {
  text: "こんにちは！",  // 読み上げるテキスト
  speaker: 1  // 話者ID（オプション）
});

2. テキストから音声合成用クエリを生成

const queryResult = await mcp.invoke("generate_query", {
  text: "こんにちは！",  // 音声合成するテキスト
  speaker: 1  // 話者ID（オプション）
});

// 返されたテキストをJSONにパース
const query = JSON.parse(queryResult.content[0].text);

3. 音声合成用クエリから音声ファイルを生成

const fileResult = await mcp.invoke("synthesize_file", {
  query: query,  // 音声合成用クエリ
  output: "/path/to/output.wav",  // 出力ファイルパス
  speaker: 1  // 話者ID（オプション）
});

// 生成された音声ファイルのパス
const filePath = fileResult.content[0].text;

活用例

テキストを直接音声に変換
- speak - 短いテキストをすぐに読み上げたいとき
細かい音声設定をカスタマイズ
- generate_query → クエリ編集 → synthesize_file の流れで高度な調整が可能
バッチ処理で大量の音声ファイルを作成
- テキストをクエリに変換してから一括で音声ファイルを生成

環境変数

VOICEVOX_URL: VOICEVOXエンジンのURL（デフォルト: http://localhost:50021）

ライセンス

ISC

MCP TTS VOICEVOX

README

MCP TTS VOICEVOX

必要条件

機能概要

使い方

インストール

実行

MCPツールとして使用

1. テキストを音声に変換して再生

2. テキストから音声合成用クエリを生成

3. 音声合成用クエリから音声ファイルを生成

活用例

環境変数

ライセンス

Recommended Servers