vv-mcp
VOICEVOX MCP Server - Claude DesktopとClaude Codeで音声合成を利用するためのMCPサーバー
必要要件
- Node.js 18以上
- VOICEVOXがインストールされ、起動していること
- サポートOS:
- macOS: を使用(追加インストール不要)
Agenten stärken
Der eigene Befehl des Herausgebers. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
npx -y @arrow2nd/[email protected]Claude Code hat keinen Installationslink für einen lokalen Befehl. Kopieren Sie den Befehl unten und führen Sie ihn in einem Terminal aus.
claude mcp add arrow2nd-vv-mcp -- npx -y @arrow2nd/vv-mcp@0.8.0In einem Terminal ausführen.
{ "mcpServers": { "arrow2nd-vv-mcp": { "command": "npx", "args": [ "-y", "@arrow2nd/[email protected]" ] } }}claude_desktop_config.json
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber
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
VOICEVOX MCP Server for text-to-speech synthesis with Claude
{ "mcpServers": { "arrow2nd-vv-mcp": { "command": "npx", "args": [ "-y", "@arrow2nd/[email protected]" ] } }}Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
@arrow2nd/vv läuft lokal über stdio.
Zuletzt geprüft: 2026-11-16. VOICEVOX MCP Server for text-to-speech synthesis with Claude