speech-mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@speech-mcp-server Transcribe the audio file at /tmp/meeting.mp3"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Speech Model Context Protocol Server
An MCP server implementation for speech of volcengine
Features
Tools
asr Automatic Speech Recognition: Converts audio to text.
Args:
content: url or absolute path of the audio file to transcribe.
Returns:
Asr text
tts Text-to-Speech: Synthesizes text into audio.
Args:
text: The text to synthesize into speech.
speed: Speech speed (e.g., 1.0 for normal). default: 1.0.
encoding: Desired audio output format (e.g., 'mp3', 'wav'). default: 'mp3'.
Returns:
Return the path of audio file.
Related MCP server: whisper-transcribe-mcp
Configuration
The server requires the following environment variables to be set:
VOLC_APPID: Required, The APP ID for the VolcEngine.VOLC_TOKEN: Required, The Access Token for the VolcEngine.VOLC_VOICE_TYPE: Optional, Large speech synthesis model service voice_type, default is 'zh_female_meilinvyou_moon_bigtts'VOLC_CLUSTER: Required, Large speech synthesis model service cluster ID
The services that need to be activated on Volcengine are: Large speech synthesis model、Streaming speech recognition large model、Large model for audio file recognition
You can set these environment variables in your shell.
MCP Settings Configuration
To add this server to your MCP configuration, add the following to your MCP settings file:
{
"mcpServers": {
"speech-mcp-server": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/src/mcp_server_speech",
"run",
"main.py"
]
}
}
}or
{
"mcpServers": {
"speech-mcp-server": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/thundersoft-td/mcp-server-speech",
"mcp-server-speech"
],
"env": {
"VOLC_APPID": "your appid",
"VOLC_TOKEN": "your token",
"VOLC_VOICE_TYPE": "tts voice type",
"VOLC_CLUSTER": "tts cluster id",
}
}
}
}Usage
Running the Server
# Run the server with stdio transport (default)
python -m mcp_server_speech [--transport/-t {sse,stdio}]License
This library is licensed under the MIT-0 License. See the LICENSE file.
Available Tools
2 toolsTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools, tts and asr, have completely distinct purposes: one synthesizes speech from text, the other converts audio to text. There is no overlap or ambiguity between them.
Both tool names are lowercase three-letter acronyms (tts, asr), following a consistent and predictable pattern. The naming style is uniform across the set.
With only 2 tools, this is on the thin side. However, the two tools cover the essential capabilities of a speech server (synthesis and recognition), making the count borderline appropriate.
The tool set covers the two core directions of speech processing (text-to-speech and automatic speech recognition), representing solid coverage. Minor gaps such as voice selection or streaming are not included, but the fundamental workflows are fully supported.
Related MCP Connectors
AI voice generation: text-to-speech and voice cloning from any MCP client.
MCP server for Text-to-Speech
MCP server for Speech-to-Text
MCP server exposing the AceDataCloud Fish Audio API (text-to-speech with voice conditioning)
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server integrated with Microsoft Edge's high-quality speech synthesis capabilities, supporting multilingual speech generation, audio merging, and cloud storage.12Apache 2.0
- AlicenseAqualityBmaintenanceMCP server for audio transcription using local faster-whisper or OpenAI Whisper API, enabling multilingual transcription with optional GPT post-processing.3180 PyPIMIT
- AlicenseAqualityCmaintenanceMCP server for generating images and videos using Volcengine's Jimeng APIs, supporting text-to-image, image-to-image, multi-image fusion, text-to-video, and image-to-video.31MIT
- AlicenseAqualityDmaintenanceMCP server integrating VolcEngine's image generation capabilities, enabling text-to-image, image-to-image, and image set generation for AI applications.427 npmMIT