speak_textLABSCO SUMMARY
Depends on an engine you start yourself.
The server is a bridge, not the synthesiser — AgentVRM has to be running before anything happens, and the README says so plainly with the endpoint it expects. What you get for that setup is more than text-to-speech: the avatar carries expressions and animation, and every generated line is written to disk as a .wav, so it can be reused in a video or a demo without another synthesis pass.
What it is
An MCP server that bridges a client to an AgentVRM engine. Text sent through it is synthesised into speech and performed by a VRM avatar with expressions and animation, rather than just being read aloud.
What you get
- Speech from text, performed by the VRM avatar, with a required
textargument and optionalspeaker_id,speed_scaleandauto_play—speak_text - Automatic playback on generation, handled per platform: the default player on Windows,
afplayon macOS, andaplayon Linux with a fallback toxdg-open - The generated audio kept as a .wav file in the assets folder, so a line can be reused rather than regenerated
Requirements
A running AgentVRM engine — it must be started manually, and the server connects to http://localhost:3001/api/speak_text by default, with --api-url to point elsewhere. Python 3.10 or higher. No install step with uv: run it straight through uvx as agent-vrm-mcp. The package is agent-vrm-mcp (version 0.1.0).
Setup effort
One command — uvx agent-vrm-mcp
USE CASES
Giving an assistant a spoken presence
Send the reply through the avatar so it is performed with expression rather than displayed as text.
Recording narration for a video
Generate the lines and take the .wav files from the assets folder into the edit.
Tuning delivery
Adjust the speaker and the speed on the call until the read sounds right, with playback on generation so you hear it immediately.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- uvx on PATH
- Python 3.10 or later
- A running AgentVRM engine (github.com/pixiv/AgentVRM), started by hand
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
uvx agent-vrm-mcpMCP Clients
Claude Desktop
{
"mcpServers": {
"vrm": {
"command": "uvx",
"args": [
"agent-vrm-mcp",
"--api-url=http://localhost:3001/api/speak_text"
]
}
}
}