Servidor MCP de Voicevox

Este es un servidor para utilizar servidores de síntesis de voz compatibles con VOICEVOX (AivisSpeech / VOICEVOX / COEIROINK) a través de MCP (Model Context Protocol). Se puede utilizar para la síntesis de voz en modo agente usando Claude 3.7 en Cursor, etc.

Prerrequisitos

Entorno de Windows

Node.js 18 o superior
MOTOR VOICEVOX, etc. ( se ejecuta localmente en http://localhost:50000, etc. )
Reproductor multimedia VLC (se debe configurar la ruta)

Entorno Docker (WSL2)

Docker y Docker Compose
WSL2
MOTOR VOICEVOX, etc. (se ejecuta localmente o en Docker)
sudo apt install libsdl2-dev pulseaudio-utils pulseaudio
Permisos de acceso a /mnt/wslg

Instalación y configuración

Clonar el repositorio

git clone https://github.com/Dosugamea/voicevox-mcp-server.git
cd voicevox-mcp-server

Instalación de dependencias

npm install

Configuración de variables de entorno Cree un archivo .env copiando .env_example y modificando la configuración según sea necesario:

VOICEVOX_API_URL=http://localhost:50021
VOICEVOX_SPEAKER_ID=1

Cómo hacerlo

Ejecución en entorno Windows

Inicie un servidor por separado del editor siguiendo los pasos a continuación.

npm run build
npm start

Ejecución en entorno Docker

No se requiere ningún editor ni operación independiente. No se puede ejecutar directamente porque se inicia en modo stdio.

Cómo configurarlo

Cuando se ejecuta en un entorno Windows

Agregue lo siguiente a mcp.json. La conexión es inestable, por lo que debe volver a conectarla si se desconecta.

        "voicevox": {
            "url": "http://localhost:10100/sse"
        }

Cuando se ejecuta en un entorno Docker

Agregue lo siguiente a mcp.json. (El entorno del autor no ha sido probado).

{
    "tools": {
        "voicevox": {
            "command": "cmd",
            "args": [
                "/c",
                "docker",
                "run",
                "-i",
                "--rm",
                "-v",
                "/mnt/wslg:/mnt/wslg",
                "-e",
                "PULSE_SERVER",
                "-e",
                "SDL_AUDIODRIVER",
                "-e",
                "VOICEVOX_API_URL",
                "-e",
                "VOICEVOX_SPEAKER_ID",
                "your-local-docker-image-name"
            ],
            "env": {
                "PULSE_SERVER": "unix:/mnt/wslg/PulseServer",
                "SDL_AUDIODRIVER": "pulseaudio",
                "VOICEVOX_API_URL": "http://host.docker.internal:50031",
                "VOICEVOX_SPEAKER_ID": "919692871"
            }
        }
    }
}

Acerca de la identificación del orador

La identificación del altavoz varía según el modelo de VOICEVOX que utilice. El valor predeterminado es utilizar "1" (Shikoku Metal). Si desea utilizar otro ID de altavoz, cambie la variable de entorno VOICEVOX_SPEAKER_ID .

La lista de identificaciones de oradores se puede encontrar en /speakers de la API VOICEVOX ENGINE. Ejemplo: curl http://localhost:50021/speakers

solución de problemas

Error de conexión con VOICEVOX : asegúrese de que VOICEVOX ENGINE se esté ejecutando y que la URL de la API esté configurada correctamente.
No se reproduce sonido : asegúrese de que VLC esté instalado correctamente y en su ruta.
Problema de salida de audio en el entorno Docker : verifique que pulseaudio esté configurado correctamente.

Información para desarrolladores

Para contribuir al código fuente, cree un problema o envíe una solicitud de extracción.
Para informar errores o solicitar funciones, utilice la función Problemas en GitHub.

licencia

Licencia MIT

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

voicevox

Un servidor que permite a Claude 3.7 y otros agentes de IA acceder a motores de síntesis de voz compatibles con VOICEVOX (AivisSpeech, VOICEVOX, COEIROINK) a través del Protocolo de Contexto de Modelo.

Related MCP Servers

MTS MCP Server
CalvinMagezi
-
security
F
license
-
quality
A comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.
Last updated -
5
TypeScript
AivisSpeech MCP Server
kentaro
A
security
F
license
A
quality
A Model Context Protocol server that enables AI assistants to utilize AivisSpeech Engine's high-quality voice synthesis capabilities through a standardized API interface.
Last updated -
1
TypeScript
TTS-MCP
nakamurau1
-
security
A
license
-
quality
A Model Context Protocol server that integrates high-quality text-to-speech capabilities with Claude Desktop and other MCP-compatible clients, supporting multiple voice options and audio formats.
Last updated -
14
1
TypeScript
MIT License
Voice Call MCP Server
popcornspace
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to initiate and manage real-time voice calls using Twilio and OpenAI's voice models.
Last updated -
44
TypeScript
MIT License

View all related MCP servers

Appeared in Searches

Tools and Applications for Text-to-Speech Conversion

Voicevox MCP Server