| Name | allvoicelab-mcp JSON |
| Version |
0.0.5
JSON |
| download |
| home_page | None |
| Summary | AllVoiceLab MCP Server |
| upload_time | 2025-08-01 07:17:26 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT License
Copyright (c) 2025 All Voice Lab
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
|
| keywords |
mcp
text-to-speech
speech-to-text
voice-cloning
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align="center" style="line-height: 1;">
<a href="https://www.allvoicelab.com" target="_blank" style="margin: 2px; color: var(--fgColor-default);">
<img alt="Homepage" src="https://img.shields.io/badge/HomePage-AllVoiceLab-blue?logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyBpZD0iX+WbvuWxgl8xIiBkYXRhLW5hbWU9IuWbvuWxgl8xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgdmlld0JveD0iMCAwIDM1IDIwIj4KICA8IS0tIEdlbmVyYXRvcjogQWRvYmUgSWxsdXN0cmF0b3IgMjkuNS4xLCBTVkcgRXhwb3J0IFBsdWctSW4gLiBTVkcgVmVyc2lvbjogMi4xLjAgQnVpbGQgMTQxKSAgLS0+CiAgPHBhdGggZD0iTTM0Ljg2LDUuMzFjLjIxLS4zMS0uMDEtLjcyLS4zOC0uNzJoLTIuOThjLS4yNCwwLS40Ni4xMi0uNTkuMzJsLTYuODksMTAuM2MtLjE3LjI2LS41NS4yNi0uNzMsMGwtMi4xNi0zLjExcy0uMDEtLjAyLS4wMi0uMDNMMTMuNjYsMS40Yy0uNTYtLjgtMS40Ny0xLjI2LTIuNDUtMS4yMi0uOTguMDQtMS44NS41Ny0yLjM1LDEuNDFMLjMyLDE2LjIzYy0uNTEuODgtLjQsMS45NC4yOCwyLjcuNzMuODEsMS45NCwxLjA2LDIuOTYuNmwuMTItLjA1LDkuMDMtNS43NGMuOTEtLjU4LDEuOTYtLjg5LDMuMDQtLjkxLjk4LDAsMS45MS40NiwyLjQ4LDEuMjZsMy4xNiw0LjU0Yy41LjcyLDEuMzUsMS4xNSwyLjI3LDEuMTVzMS43Ny0uNDMsMi4yOS0xLjE3bDguOTEtMTMuMzFoMFpNNi41OSwxMi40NWw0LjQyLTcuNTdjLjE3LS4yOS41OC0uMzEuNzctLjAzbDIuNzIsMy45Yy4xOS4yNy4wMy42NC0uMy43LTEuMi4yMS0yLjM1LjY1LTMuMzksMS4zMWwtMy41OSwyLjI4Yy0uNC4yNS0uODctLjItLjYzLS42MWgwWiIvPgo8L3N2Zz4=" style="display: inline-block; vertical-align: middle;"/>
</a>
<a href="https://www.allvoicelab.com/docs/introduction" style="margin: 2px;">
<img alt="API" src="https://img.shields.io/badge/⚡_API-Platform-blue" style="display: inline-block; vertical-align: middle;"/>
</a>
<a href="https://github.com/allvoicelab/AllVoiceLab-MCP/blob/main/LICENSE" style="margin: 2px;">
<img alt="Code License" src="https://img.shields.io/badge/_Code_License-MIT-blue" style="display: inline-block; vertical-align: middle;"/>
</a>
</div>
<p align="center">
Official AllVoiceLab Model Context Protocol (MCP) server, supporting interaction with powerful text-to-speech and video translation APIs. Enables MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents to generate speech, translate videos, and perform intelligent voice conversion. Serves scenarios such as short drama localization for global markets, AI-Generated audiobooks, AI-Powered production of film/TV narration.
</p>
## Why Choose AllVoiceLab MCP Server?
- Multi-engine technology unlocks infinite possibilities for voice: With simple text input, you can access video generation, speech synthesis, voice cloning, and more.
- AI Voice Generator (TTS): Natural voice generation in 30+ languages with ultra-high realism
- Voice Changer: Real-time voice conversion, ideal for gaming, live streaming, and privacy protection
- Vocal Separation: Ultra-fast 5ms separation of vocals and background music, with industry-leading precision
- Multilingual Dubbing: One-click translation and dubbing for short videos/films, preserving emotional tone and rhythm
- Speech-to-Text (STT): AI-powered multilingual subtitle generation with over 98% accuracy
- Subtitle Removal: Seamless hard subtitle erasure, even on complex backgrounds
- Voice Cloning: 3-Second Ultra-Fast Cloning with Human-like Voice Synthesis
## Documentation
[中文文档](https://github.com/allvoicelab/AllVoiceLab-MCP/blob/main/doc/README_CN.md)
## Quickstart
1. Get your API key from [AllVoiceLab](https://www.allvoicelab.com/).
2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh`
3. **Important**: The server addresses of APIs in different regions need to match the keys of the corresponding regions, otherwise there will be an error that the tool is unavailable.
|Region| Global | Mainland |
|:--|:-----|:-----|
|ALLVOICELAB_API_KEY| go get from [AllVoiceLab](https://www.allvoicelab.com/workbench/api-keys) | go get from [AllVoiceLab](https://www.allvoicelab.cn/workbench/api-keys) |
|ALLVOICELAB_API_DOMAIN| https://api.allvoicelab.com | https://api.allvoicelab.cn |
### Claude Desktop
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
```json
{
"mcpServers": {
"AllVoiceLab": {
"command": "uvx",
"args": ["allvoicelab-mcp"],
"env": {
"ALLVOICELAB_API_KEY": "<insert-your-api-key-here>",
"ALLVOICELAB_API_DOMAIN": "<insert-api-domain-here>",
"ALLVOICELAB_BASE_PATH":"optional, default is user home directory.This is uesd to store the output files."
}
}
}
}
```
If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".
### Cursor
Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add above config.
That's it. Your MCP client can now interact with AllVoiceLab.
## Available methods
| Methods | Brief description |
| --- | --- |
| text_to_speech | Convert text to speech |
| speech_to_speech | Convert audio to another voice while preserving the speech content |
| isolate_human_voice | Extract clean human voice by removing background noise and non-speech sounds |
| clone_voice | Create a custom voice profile by cloning from an audio sample |
| remove_subtitle | Remove hardcoded subtitles from a video using OCR |
| video_translation_dubbing | Translate and dub video speech into different languages |
| text_translation | Translate a text file into another language |
| subtitle_extraction | Extract subtitles from a video using OCR |
## Example usage
⚠️ Warning: AllVoiceLab credits are needed to use these tools.
### 1. Text to Speech
Try asking: Convert "At All Voice Lab, we’re reshaping the future of audio workflows with AI-powered solutions, making authentic voices accessible to creators everywhere." into voice.
### 2. Voice Conversion
After generating the audio from the previous example, select the audio file and ask: Convert this to a male voice.
### 3. Remove Background Noise
Select an audio file with rich sounds (containing both BGM and human voice) and ask: Remove the background noise.
### 4. Voice Cloning
Select an audio file with a single voice and ask: Clone this voice.
### 5. Video Translation
Select a video file (English) and ask: Translate this video to japanese.
Original video:
After translation:
### 6. Remove Subtitles
Select a video with subtitles and ask: Remove the subtitles from this video.
Original video:
After the task is completed:
### 7. Text Translation
Select a long text (for example, "The Foolish Old Man Removes the Mountains") and ask: Translate this text to japanese.
If no language is specified, it will be translated to English by default.
### 8. Subtitle Extraction
Select a video with subtitles and ask: Extract the subtitles from this video.
After the task is completed, you will get an SRT file as shown below:
## Troubleshooting
Logs can be found at:
- Windows: C:\Users\<Username>\.mcp\allvoicelab_mcp.log
- macOS: ~/.mcp/allvoicelab_mcp.log
Please contact us by email(tech@allvoicelab.com) with log files
Raw data
{
"_id": null,
"home_page": null,
"name": "allvoicelab-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "mcp, text-to-speech, speech-to-text, voice-cloning",
"author": null,
"author_email": "AllVoiceLab <tech@allvoicelab.com>",
"download_url": "https://files.pythonhosted.org/packages/06/45/317d002a9a748fbba772480bad4b14152ba9a2e5f7996cda90290e9bad35/allvoicelab_mcp-0.0.5.tar.gz",
"platform": null,
"description": "\n\n<div align=\"center\" style=\"line-height: 1;\">\n <a href=\"https://www.allvoicelab.com\" target=\"_blank\" style=\"margin: 2px; color: var(--fgColor-default);\">\n <img alt=\"Homepage\" src=\"https://img.shields.io/badge/HomePage-AllVoiceLab-blue?logo=data:image/svg+xml;base64,PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPHN2ZyBpZD0iX+WbvuWxgl8xIiBkYXRhLW5hbWU9IuWbvuWxgl8xIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZlcnNpb249IjEuMSIgdmlld0JveD0iMCAwIDM1IDIwIj4KICA8IS0tIEdlbmVyYXRvcjogQWRvYmUgSWxsdXN0cmF0b3IgMjkuNS4xLCBTVkcgRXhwb3J0IFBsdWctSW4gLiBTVkcgVmVyc2lvbjogMi4xLjAgQnVpbGQgMTQxKSAgLS0+CiAgPHBhdGggZD0iTTM0Ljg2LDUuMzFjLjIxLS4zMS0uMDEtLjcyLS4zOC0uNzJoLTIuOThjLS4yNCwwLS40Ni4xMi0uNTkuMzJsLTYuODksMTAuM2MtLjE3LjI2LS41NS4yNi0uNzMsMGwtMi4xNi0zLjExcy0uMDEtLjAyLS4wMi0uMDNMMTMuNjYsMS40Yy0uNTYtLjgtMS40Ny0xLjI2LTIuNDUtMS4yMi0uOTguMDQtMS44NS41Ny0yLjM1LDEuNDFMLjMyLDE2LjIzYy0uNTEuODgtLjQsMS45NC4yOCwyLjcuNzMuODEsMS45NCwxLjA2LDIuOTYuNmwuMTItLjA1LDkuMDMtNS43NGMuOTEtLjU4LDEuOTYtLjg5LDMuMDQtLjkxLjk4LDAsMS45MS40NiwyLjQ4LDEuMjZsMy4xNiw0LjU0Yy41LjcyLDEuMzUsMS4xNSwyLjI3LDEuMTVzMS43Ny0uNDMsMi4yOS0xLjE3bDguOTEtMTMuMzFoMFpNNi41OSwxMi40NWw0LjQyLTcuNTdjLjE3LS4yOS41OC0uMzEuNzctLjAzbDIuNzIsMy45Yy4xOS4yNy4wMy42NC0uMy43LTEuMi4yMS0yLjM1LjY1LTMuMzksMS4zMWwtMy41OSwyLjI4Yy0uNC4yNS0uODctLjItLjYzLS42MWgwWiIvPgo8L3N2Zz4=\" style=\"display: inline-block; vertical-align: middle;\"/>\n </a>\n <a href=\"https://www.allvoicelab.com/docs/introduction\" style=\"margin: 2px;\">\n <img alt=\"API\" src=\"https://img.shields.io/badge/\u26a1_API-Platform-blue\" style=\"display: inline-block; vertical-align: middle;\"/>\n </a>\n <a href=\"https://github.com/allvoicelab/AllVoiceLab-MCP/blob/main/LICENSE\" style=\"margin: 2px;\">\n <img alt=\"Code License\" src=\"https://img.shields.io/badge/_Code_License-MIT-blue\" style=\"display: inline-block; vertical-align: middle;\"/>\n </a>\n</div>\n\n\n<p align=\"center\">\n\nOfficial AllVoiceLab Model Context Protocol (MCP) server, supporting interaction with powerful text-to-speech and video translation APIs. Enables MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents to generate speech, translate videos, and perform intelligent voice conversion. Serves scenarios such as short drama localization for global markets, AI-Generated audiobooks, AI-Powered production of film/TV narration.\n\n</p>\n\n## Why Choose AllVoiceLab MCP Server?\n\n- Multi-engine technology unlocks infinite possibilities for voice: With simple text input, you can access video generation, speech synthesis, voice cloning, and more.\n- AI Voice Generator (TTS): Natural voice generation in 30+ languages with ultra-high realism\n- Voice Changer: Real-time voice conversion, ideal for gaming, live streaming, and privacy protection\n- Vocal Separation: Ultra-fast 5ms separation of vocals and background music, with industry-leading precision\n- Multilingual Dubbing: One-click translation and dubbing for short videos/films, preserving emotional tone and rhythm\n- Speech-to-Text (STT): AI-powered multilingual subtitle generation with over 98% accuracy\n- Subtitle Removal: Seamless hard subtitle erasure, even on complex backgrounds\n- Voice Cloning: 3-Second Ultra-Fast Cloning with Human-like Voice Synthesis \n\n## Documentation\n\n[\u4e2d\u6587\u6587\u6863](https://github.com/allvoicelab/AllVoiceLab-MCP/blob/main/doc/README_CN.md)\n\n## Quickstart\n\n1. Get your API key from [AllVoiceLab](https://www.allvoicelab.com/).\n2. Install `uv` (Python package manager), install with `curl -LsSf https://astral.sh/uv/install.sh | sh`\n3. **Important**: The server addresses of APIs in different regions need to match the keys of the corresponding regions, otherwise there will be an error that the tool is unavailable.\n\n|Region| Global | Mainland |\n|:--|:-----|:-----|\n|ALLVOICELAB_API_KEY| go get from [AllVoiceLab](https://www.allvoicelab.com/workbench/api-keys) | go get from [AllVoiceLab](https://www.allvoicelab.cn/workbench/api-keys) |\n|ALLVOICELAB_API_DOMAIN| https://api.allvoicelab.com | https://api.allvoicelab.cn |\n\n### Claude Desktop\n\nGo to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:\n```json\n{\n \"mcpServers\": {\n \"AllVoiceLab\": {\n \"command\": \"uvx\",\n \"args\": [\"allvoicelab-mcp\"],\n \"env\": {\n \"ALLVOICELAB_API_KEY\": \"<insert-your-api-key-here>\",\n \"ALLVOICELAB_API_DOMAIN\": \"<insert-api-domain-here>\",\n \"ALLVOICELAB_BASE_PATH\":\"optional, default is user home directory.This is uesd to store the output files.\"\n }\n }\n }\n}\n```\n\nIf you're using Windows, you will have to enable \"Developer Mode\" in Claude Desktop to use the MCP server. Click \"Help\" in the hamburger menu in the top left and select \"Enable Developer Mode\".\n\n### Cursor\nGo to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add above config.\n\nThat's it. Your MCP client can now interact with AllVoiceLab.\n\n\n## Available methods\n\n| Methods | Brief description |\n| --- | --- |\n| text_to_speech | Convert text to speech |\n| speech_to_speech | Convert audio to another voice while preserving the speech content |\n| isolate_human_voice | Extract clean human voice by removing background noise and non-speech sounds |\n| clone_voice | Create a custom voice profile by cloning from an audio sample |\n| remove_subtitle | Remove hardcoded subtitles from a video using OCR |\n| video_translation_dubbing | Translate and dub video speech into different languages \u200b\u200b|\n| text_translation | Translate a text file into another language |\n| subtitle_extraction | Extract subtitles from a video using OCR |\n\n## Example usage\n\n\u26a0\ufe0f Warning: AllVoiceLab credits are needed to use these tools.\n\n### 1. Text to Speech\n\nTry asking: Convert \"At All Voice Lab, we\u2019re reshaping the future of audio workflows with AI-powered solutions, making authentic voices accessible to creators everywhere.\" into voice.\n\n\n\n### 2. Voice Conversion\n\nAfter generating the audio from the previous example, select the audio file and ask: Convert this to a male voice.\n\n\n\n### 3. Remove Background Noise\n\nSelect an audio file with rich sounds (containing both BGM and human voice) and ask: Remove the background noise.\n\n\n\n### 4. Voice Cloning\n\nSelect an audio file with a single voice and ask: Clone this voice.\n\n\n\n### 5. Video Translation\n\nSelect a video file (English) and ask: Translate this video to japanese.\n\n\n\nOriginal video: \n\n\n\nAfter translation: \n\n\n\n### 6. Remove Subtitles\n\nSelect a video with subtitles and ask: Remove the subtitles from this video.\n\n\n\nOriginal video: \n\n\n\nAfter the task is completed: \n\n\n\n### 7. Text Translation\n\nSelect a long text (for example, \"The Foolish Old Man Removes the Mountains\") and ask: Translate this text to japanese.\nIf no language is specified, it will be translated to English by default.\n\n\n\n### 8. Subtitle Extraction\n\nSelect a video with subtitles and ask: Extract the subtitles from this video.\n\n\n\nAfter the task is completed, you will get an SRT file as shown below:\n\n\n\n## Troubleshooting\n\nLogs can be found at:\n\n- Windows: C:\\Users\\<Username>\\.mcp\\allvoicelab_mcp.log\n- macOS: ~/.mcp/allvoicelab_mcp.log\n\nPlease contact us by email(tech@allvoicelab.com) with log files\n",
"bugtrack_url": null,
"license": "MIT License\n \n Copyright (c) 2025 All Voice Lab\n \n Permission is hereby granted, free of charge, to any person obtaining a copy\n of this software and associated documentation files (the \"Software\"), to deal\n in the Software without restriction, including without limitation the rights\n to use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n copies of the Software, and to permit persons to whom the Software is\n furnished to do so, subject to the following conditions:\n \n The above copyright notice and this permission notice shall be included in all\n copies or substantial portions of the Software.\n \n THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n SOFTWARE.\n ",
"summary": "AllVoiceLab MCP Server",
"version": "0.0.5",
"project_urls": null,
"split_keywords": [
"mcp",
" text-to-speech",
" speech-to-text",
" voice-cloning"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4eb553e175969e98158dadfd0b4a9c0715843847c3bf1c76fae2c0362524e98d",
"md5": "60d1bdf6e24c9f352c70e3cb3b9ff1e2",
"sha256": "a40589d980394914dfb09ad22dc6cf16c2a21348d47b497c71d942b2ee424aa9"
},
"downloads": -1,
"filename": "allvoicelab_mcp-0.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "60d1bdf6e24c9f352c70e3cb3b9ff1e2",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 73375,
"upload_time": "2025-08-01T07:17:25",
"upload_time_iso_8601": "2025-08-01T07:17:25.168587Z",
"url": "https://files.pythonhosted.org/packages/4e/b5/53e175969e98158dadfd0b4a9c0715843847c3bf1c76fae2c0362524e98d/allvoicelab_mcp-0.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0645317d002a9a748fbba772480bad4b14152ba9a2e5f7996cda90290e9bad35",
"md5": "6fe0ac3e5bca0adf80afb2c69e6feb13",
"sha256": "acec4150b33f3b3d6bb1f27f01437e03f2257447bf44a252a840e9eeda50fef8"
},
"downloads": -1,
"filename": "allvoicelab_mcp-0.0.5.tar.gz",
"has_sig": false,
"md5_digest": "6fe0ac3e5bca0adf80afb2c69e6feb13",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 61461,
"upload_time": "2025-08-01T07:17:26",
"upload_time_iso_8601": "2025-08-01T07:17:26.706477Z",
"url": "https://files.pythonhosted.org/packages/06/45/317d002a9a748fbba772480bad4b14152ba9a2e5f7996cda90290e9bad35/allvoicelab_mcp-0.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-01 07:17:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "allvoicelab-mcp"
}
