Mobvoi-MCP

<p align="center"> <a href="https://pypi.org/project/mobvoi-mcp/"><img src="https://img.shields.io/badge/pypi-mobvoimcp-green" alt="版本"></a> <a href="https://openapi.moyin.com/index/"><img src="https://img.shields.io/badge/openapi-SeqMonkey-orange" alt="版本"></a> <a href="https://www.moyin.com/"><img src="https://img.shields.io/badge/魔音工坊-出门问问-red" alt="版本"></a> <a href="https://www.dupdub.com/"><img src="https://img.shields.io/badge/dupdub-Mobvoi-yellow" alt="版本"></a> <a href="https://sparkaudio.github.io/spark-tts/"><img src="https://img.shields.io/badge/github-sparktts-blue" alt="版本"></a> </p> <p align="center"> 出门问问官方的 <a href="https://github.com/modelcontextprotocol">模型上下文协议（MCP）</a> 服务器，支持与出门问问强大的文本转语音、声音克隆、照片驱动的虚拟形象、视频配音、视频翻译等API进行交互。此服务器允许MCP客户端如 <a href="https://www.cursor.so">Cursor</a>、<a href="https://www.anthropic.com/claude">Claude Desktop</a>、<a href="https://cline.bot/">Cline</a>、<a href="https://windsurf.com/editor">Windsurf</a> 等调用工具生成语音、克隆声音、驱动虚拟形象、视频配音、视频翻译等功能。出门问问MCP服务器基于Python构建，我们的PyPI包发布在PyPI上，您可以点击 <a href="https://pypi.org/project/mobvoi-mcp/">PyPI</a> 查看最新版本。 </p>

先决条件

1. Python 3.10+；
2. 获取您的app_key和app_secret：
   • 对于中国大陆用户：您可以在出门问问序列猴子开放平台获取您的APP_KEY和APP_SECRET。新用户可以申请免费配额。
   • 对于海外用户：我们即将推出。
3. 配置环境变量，例如APP_KEY、APP_SECRET、MOBVOI_MCP_REGION和MOBVOI_MCP_BASE_PATH。我将在后面提供示例说明。
   • MOBVOI_MCP_REGION：“mainland”默认值。海外用户需要配置“global”（即将推出）。
   • MOBVOI_MCP_BASE_PATH：工具调用结果的存储路径。
4. 安装uv（Python包管理器），使用pip install uv安装或参见uv 仓库了解其他安装方法。

出门问问MCP能做什么？

出门问问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将打开，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "<在此处插入您的APP_KEY>",
          "APP_SECRET": "<在此处插入您的APP_SECRET>",
          "MOBVOI_MCP_REGION": "可选，默认为mainland，选择mainland | global",
          "MOBVOI_MCP_BASE_PATH": "可选，默认为~/Desktop"
        },
      },

快速开始使用Claude Desktop

前往Claude Desktop -> 设置 -> 开发者，点击编辑配置并打开claude_desktop_config.json，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "<在此处插入您的APP_KEY>",
          "APP_SECRET": "<在此处插入您的APP_SECRET>",
          "MOBVOI_MCP_REGION": "可选，默认为mainland，选择mainland | global",
          "MOBVOI_MCP_BASE_PATH": "可选，默认为~/Desktop"
        },
      },

快速开始使用Cline

在VSCode扩展中安装Cline插件，然后前往Cline -> MCP服务器 -> 已安装，点击配置MCP服务器，cline_mcp_settings.json将被打开，粘贴以下配置内容：

"Mobvoi": {
        "command": "uvx",
        "args": [
          "mobvoi-mcp"
        ],
        "env": {
          "APP_KEY": "<在此处插入您的APP_KEY>",
          "APP_SECRET": "<在此处插入您的APP_SECRET>",
          "MOBVOI_MCP_REGION": "可选，默认为mainland，选择mainland | global",
          "MOBVOI_MCP_BASE_PATH": "可选，默认为~/Desktop"
        },
        "transportType": "stdio"
      },

对于MacOS和Linux系统，可以参考上述方式进行配置。我们尚未测试Windows系统。

源代码测试

如果您想基于源代码进行测试或在此仓库基础上进行二次开发，可以按照以下方式配置：

"MobvoiLocal": {
      "disabled": false,
      "timeout": 60,
      "command": "uv",
      "args": [
        "--directory",
        "<mobvoi-mcp路径>/mobvoi_mcp",
        "run",
        "server.py"
      ],
      "env": {
          "APP_KEY": "<在此处插入您的APP_KEY>",
          "APP_SECRET": "<在此处插入您的APP_SECRET>",
          "MOBVOI_MCP_REGION": "可选，默认为mainland，选择mainland | global",
          "MOBVOI_MCP_BASE_PATH": "可选，默认为~/Desktop"
      },
      "transportType": "stdio"
    },

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

示例用法

1. 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"
        ],
       ...
      },