Mobvoi MCP

Official Mobvoi Model Context Protocol (MCP) server that enables interaction with Mobvoi powerful Text to Speech, Voice Clone, Photo-Driven Avatar, Video Dubbing, Video Translation APIs. This server allows MCP clients like Cursor, Claude Desktop, Cline , Windsurf and other Client to call tools to generate speech, clone voices, photo drive avatar, video dubbing, video translation and more. The mobvoi-mcp server is built based on Python, our PyPI package is published at Pypi, you can click on Pypi to view the latest version.

先决条件

1. python 3.10+；
2. 获取您的app_key和app_secret：

- 对于中国大陆的用户：您可以从以下网址获取您的APP_KEY和APP_SECRET 出门问问Sequence Monkey开放平台。新用户可以申请免费配额。 - 对于海外用户：我们很快就会推出。

1. 配置环境变量，如APP_KEY、APP_SECRET、MOBVOI_MCP_REGION和MOBVOI_MCP_BASE_PATH。稍后我将提供示例解释。

- MOBVOI_MCP_REGION：默认为“大陆”。海外用户需要配置“全局”（即将推出）。 - MOBVOI_MCP_BASE_PATH：工具调用结果的存储路径。

1. 安装 uv （Python包管理器），安装 pip install uv 或查看 uv 仓库 有关其他安装方法。

出门问问MCP能做什么？

出门问问MCP现在提供以下工具供客户端调用。

使用游标快速入门

转到光标->光标设置->MCP，单击 Add new global MCP server，打开mcp.json，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "",
          "APP_SECRET": "",
          "MOBVOI_MCP_REGION": "optional, mainland is default, choose from mainland | global",
          "MOBVOI_MCP_BASE_PATH": "optional, ~/Desktop is default" 
        },
      },

Claude Desktop快速入门

转到克劳德桌面->设置->开发人员，单击 Edit Config 并打开 claude_desktop_config.json，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "",
          "APP_SECRET": "",
          "MOBVOI_MCP_REGION": "optional, mainland is default, choose from mainland | global",
          "MOBVOI_MCP_BASE_PATH": "optional, ~/Desktop is default"
        },
      },

与Cline快速入门

在VSCode EXTENSIONS上安装Cline扩展，然后转到Cline->MCP服务器->已安装，单击 Config MCP Servers 和 cline_mcp_settings.json 将打开，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "",
          "APP_SECRET": "",
          "MOBVOI_MCP_REGION": "optional, mainland is default, choose from mainland | global",
          "MOBVOI_MCP_BASE_PATH": "optional, ~/Desktop is default"
        },
        "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": "optional, mainland is default, choose from mainland | global",
          "MOBVOI_MCP_BASE_PATH": "optional, ~/Desktop is default"
      },
      "transportType": "stdio"
    },

以Cline为例，其他客户端的配置也类似。

示例用法

1. TTS演示视频：

故障排除

产卵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 如果您可以看到最新版本号与PyPI上的版本号一致，则可以使用镜像源来更新最新的mobvoi-mcp包。否则，您只能使用https://pypi.org/simple为了更新。通常，在PyPI上发布新包后，镜像源同步会有几十分钟的延迟。 同时，您可以参考以下配置来更新和清除缓存。

"Mobvoi": {
        ...
        "args": [
          "--upgrade",
          "--no-cache-dir",
          "--index", 
          "https://pypi.tuna.tsinghua.edu.cn/simple",
          "mobvoi-mcp"
        ],
       ...
      },