vv-mcp
VOICEVOX MCP Server - Claude DesktopとClaude Codeで音声合成を利用するためのMCPサーバー
必要要件
- Node.js 18以上
- VOICEVOXがインストールされ、起動していること
- サポートOS:
- macOS: を使用(追加インストール不要)
接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
npx -y @arrow2nd/[email protected]Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
claude mcp add arrow2nd-vv-mcp -- npx -y @arrow2nd/vv-mcp@0.8.0在終端機中執行。
{ "mcpServers": { "arrow2nd-vv-mcp": { "command": "npx", "args": [ "-y", "@arrow2nd/[email protected]" ] } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
VOICEVOX MCP Server - Claude DesktopとClaude Codeで音声合成を利用するためのMCPサーバー
VOICEVOX MCP Server for text-to-speech synthesis with Claude
afplaypw-play(PipeWire)または paplay(PulseAudio)が必要
pw-play を優先的に使用し、なければ paplay にフォールバックpacman -S pipewireapt install pipewire-bindnf install pipewire-utilspacman -S pulseaudioapt install pulseaudio-utilsdnf install pulseaudio-utilsnpm install -g @arrow2nd/vv-mcp
git clone https://github.com/arrow2nd/vv-mcp.git
cd vv-mcp
npm install
npm run build
設定ファイルを編集:
~/Library/Application Support/Claude/claude_desktop_config.json~/.config/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"vv-mcp": {
"command": "npx",
"args": ["-y", "@arrow2nd/vv-mcp"],
"env": {
"VOICEVOX_URL": "http://localhost:50021",
"DEFAULT_VOICE_ID": "47",
"DEFAULT_SPEED": "1.0"
}
}
}
}
{
"mcpServers": {
"vv-mcp": {
"command": "node",
"args": ["/path/to/vv-mcp/dist/index.js"],
"env": {
"VOICEVOX_URL": "http://localhost:50021",
"DEFAULT_VOICE_ID": "47",
"DEFAULT_SPEED": "1.0"
}
}
}
}
~/.claude.jsonのmcpServersセクションに以下を追加:
{
"mcpServers": {
"vv-mcp": {
"command": "npx",
"args": ["-y", "@arrow2nd/vv-mcp"],
"env": {
"VOICEVOX_URL": "http://localhost:50021",
"DEFAULT_VOICE_ID": "47",
"DEFAULT_SPEED": "1.0"
}
}
}
}
bunxを使用する場合は"command": "bunx"に変更してください。
{
"mcpServers": {
"vv-mcp": {
"command": "node",
"args": ["/path/to/vv-mcp/dist/index.js"],
"env": {
"VOICEVOX_URL": "http://localhost:50021",
"DEFAULT_VOICE_ID": "47",
"DEFAULT_SPEED": "1.0"
}
}
}
}
Claude Desktop/Codeを再起動後、以下のMCPツールが利用可能になります:
say - テキストを音声合成して再生(非同期実行)list_voices - 利用可能な音声一覧を取得get_queue_status - 再生キューの状態を確認clear_queue - 再生キューをクリアget_voices_in_use - 現在使用中の音声IDのリストを取得(全プロセス共通)get_random_unused_voice - 使用されていない音声をランダムに1つ取得get_session_voice - このセッションで使用する音声を取得(セッション毎に固定)「こんにちは」と言って
ナースロボの楽々な声で「完了しました」と言って
利用可能な音声を教えて
各Claudeセッションに固定の音声を自動割り当てする機能があります:
# セッション音声を使用して読み上げ
"こんにちは"とセッション音声で言って
useSessionVoice: true - セッション音声を使用(voiceIdは無視される)useSessionVoice: false(デフォルト) -
指定した音声IDまたはデフォルト音声を使用複数のClaude Desktop/Codeが同時に動作している場合、自動的に異なる音声を使用して音声の重複を避けます。
get_random_unused_voiceツールで未使用の音声を自動選択MIT
{ "mcpServers": { "arrow2nd-vv-mcp": { "command": "npx", "args": [ "-y", "@arrow2nd/[email protected]" ] } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
@arrow2nd/vv 透過 stdio 在本機執行。
上次檢查時間:2026-11-16。 VOICEVOX MCP Server for text-to-speech synthesis with Claude