Information
官方的Model Context Protocol (MCP)服务器，支持与Mobvoi强大的文本转语音、声音克隆、照片驱动虚拟形象、视频配音、视频翻译等API进行交互。该服务器允许如Cursor、Claude Desktop、Cline、Windsurf等MCP客户端调用工具生成语音、克隆声音、照片驱动虚拟形象、视频配音、视频翻译等功能。mobvoi-mcp服务器基于Python构建，我们的PyPI包发布在Pypi上，你可以点击Pypi查看最新版本。
前提条件
Python 3.10+;
获取你的app_key和app_secret：
对于中国大陆用户：你可以在Mobvoi Sequence Monkey开放平台
获取你的APP_KEY和APP_SECRET。新用户可以申请免费配额。
对于海外用户：我们即将推出。
配置环境变量，例如APP_KEY, APP_SECRET, MOBVOI_MCP_REGION, 和MOBVOI_MCP_BASE_PATH。稍后我会提供示例说明。
MOBVOI_MCP_REGION：默认为"mainland"。海外用户需要配置为"global"（即将推出）。
MOBVOI_MCP_BASE_PATH：工具调用结果的存储路径。
安装uv（Python包管理器），使用pip install uv安装或参见uv 仓库获取更多安装方法。
Mobvoi MCP能做什么？
Mobvoi MCP现在为客户端提供了以下可调用工具。
工具描述get_speaker_list列出所有可用的声音text_to_speech使用指定的声音将文本转换为语音voice_clone从给定的URL或本地音频文件克隆一个声音play_audio播放本地音频文件photo_drive_avatar根据给定的图片URL和音频URL生成视频query_photo_drive_avatar查询照片驱动虚拟形象任务的结果video_dubbing执行配音任务，根据给定的视频URL和音频URL生成视频query_video_dubbing查询视频配音任务的结果
使用Cursor快速开始
前往Cursor -> Cursor设置 -> MCP，点击添加新的全局MCP服务器，mcp.json将会打开，粘贴以下配置内容：
"MobvoiLocal": \{
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"--directory",
"/mobvoi_mcp",
"run",
"server.py"
],
"env": \{
"APP_KEY": "",
"APP_SECRET": "",
"MOBVOI_MCP_REGION": ""
\},
"transportType": "stdio"
\},
使用Claude Desktop快速开始
前往Claude Desktop -> 设置 -> 开发者，点击编辑配置并打开claude_desktop_config.json，粘贴以下配置内容：
"MobvoiLocal": \{
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"--directory",
"/mobvoi_mcp",
"run",
"server.py"
],
"env": \{
"APP_KEY": "",
"APP_SECRET": "",
"MOBVOI_MCP_REGION": ""
\},
"transportType": "stdio"
\},
使用Cline快速开始
在VSCode扩展中安装Cline扩展，然后转到Cline -> MCP Servers -> 已安装，点击配置MCP服务器，cline_mcp_settings.json
将被打开，粘贴以下配置内容：
"MobvoiLocal": \{
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"--directory",
"/mobvoi_mcp",
"run",
"server.py"
],
"env": \{
"APP_KEY": "",
"APP_SECRET": "",
"MOBVOI_MCP_REGION": ""
\},
"transportType": "stdio"
\},
对于MacOS和Linux系统，您可以参照上述步骤进行配置。我们尚未测试Windows系统。
源代码测试
如果您希望基于源代码进行测试或基于此仓库进行二次开发，可以按如下方式配置：
"MobvoiLocal": \{
"disabled": false,
"timeout": 60,
"command": "uv",
"args": [
"--directory",
"/mobvoi_mcp",
"run",
"server.py"
],
"env": \{
"APP_KEY": "",
"APP_SECRET": "",
"MOBVOI_MCP_REGION": ""
\},
"transportType": "stdio"
\},
以Cline为例，其他客户端的配置类似。
示例用法
TTS演示视频:
故障排除
spawn uvx ENOENT
如果您遇到错误“MCP Mobvoi: spawn uvx ENOENT”，请通过在终端运行以下命令来确认其绝对路径：
which uvx
一旦您获得了绝对路径（例如，/usr/local/bin/uvx），请更新您的配置以使用该路径（例如，“command”:
“/usr/local/bin/uvx”）。这确保引用了正确的可执行文件。
MCP错误-32001：请求超时
如果遇到此错误，表明您的网络存在问题。如果您在中国大陆，强烈建议您按照以下方式配置额外的pypi源：
"Mobvoi": \{
...
"args": [
"--index",
"https://pypi.tuna.tsinghua.edu.cn/simple",
"mobvoi-mcp"
],
...
\},
请注意，额外的pypi源需要配置在args的最前面。
无法同步最新的PyPI包
如果您遇到这种情况，可能是由以下原因造成的：1) 网络问题；2) 缓存问题；3) 指定的镜像源未同步mobvoi-mcp包。
如果您正在使用镜像源，应首先检查您使用的镜像源上是否已同步mobvoi-mcp包，方法如下：
pip index versions --index-url https://pypi.tuna.tsinghua.edu.cn/simple mobvoi-mcp
如果您能看到LATEST版本号与PyPI上的一致，则可以使用镜像源来更新最新的mobvoi-mcp包。否则，您只能使用https:
//pypi.org/simple来进行更新。通常，在PyPI上发布新包后，镜像源同步会有数十分钟的延迟。
同时，您可以参考以下配置来更新并清除缓存。
"Mobvoi": \{
...
"args": [
"--upgrade",
"--no-cache-dir",
"--index",
"https://pypi.tuna.tsinghua.edu.cn/simple",
"mobvoi-mcp"
],
...
\},
请提供需要翻译的英文技术文档内容。您目前只提供了翻译要求，但没有给出具体的文档文本。请将文档的具体内容分享给我，以便我能够帮助您进行翻译。