Spimov Ai Video Clone Dubbing Mcp Server

spimov-mcp

Spimov 的 MCP 服务——通过 Claude Desktop / Claude Code / 任意 MCP 客户端为视频配音。

两种传输方式：

• stdio——在本地运行，由 MCP 客户端启动，使用 SPIMOV_API_KEY 环境变量进行身份验证。支持上传本地文件（create_dub）。
• HTTP——长时间运行的服务（由我们托管于 mcp.spimov.com），每个请求都通过 Authorization: Bearer spk_live_...（或 ?api_key=）进行身份验证。提供 Streamable HTTP（/mcp，当前规范）和旧版 SSE（/sse）。
• 仅支持 URL——不支持上传本地文件。

两种传输方式都是对 https://spimov.com/api/v1 公共 REST API 的轻量封装。使用相同的 API 密钥，且共享每日请求配额。

---

1. 获取 API 密钥

登录 https://spimov.com → Settings → API keys → Create new key。复制仅显示一次的 spk_live_... 令牌。

2a. 通过 stdio 使用（Claude Desktop）

安装：

pip install spimov-mcp

将以下内容添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "spimov": {
      "command": "spimov-mcp",
      "env": {
        "SPIMOV_API_KEY": "spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

重启 Claude Desktop。此时应会出现“spimov” MCP 服务；请 Claude“使用 Spimov 将 /Users/me/Movies/clip.mp4 配成土耳其语”。

2b. 通过 HTTP 使用（Claude Code / Claude web / 其他客户端）

可自托管：MCP_PORT=8001 spimov-mcp-http。托管端点：

• Streamable HTTP（推荐）：https://mcp.spimov.com/mcp
• 旧版 SSE：https://mcp.spimov.com/sse

Claude Code / 配置文件客户端（通过标头进行身份验证）：

{
  "mcpServers": {
    "spimov": {
      "url": "https://mcp.spimov.com/mcp",
      "headers": {
        "Authorization": "Bearer spk_live_xxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Claude web（claude.ai → Settings → Connectors → Add custom connector）：界面只接受 URL，因此请将密钥放入查询字符串：

https://mcp.spimov.com/mcp?api_key=spk_live_xxxxxxxxxxxxxxxxxxxxxxxx

密钥会随 URL 传输（并存储在连接器配置中）。请像对待密码一样保护它；如果密钥泄露，请前往 Settings → API keys 轮换密钥。本地文件工具（create_dub、download_video）在此处不可用——请使用 dub_youtube 配音，并使用 get_download_url 获取可点击的浏览器下载链接，以下载完成后的 MP4 文件。

3. 工具

工具	用途
create_dub	上传本地文件并创建配音任务（仅限 stdio）。
dub_youtube	在服务端为 YouTube URL 配音；可选自动上传到频道。
get_job_status	查询任务状态（queued / processing / review / completed / failed）。
list_jobs	查看账户的近期任务。
list_segments	获取任务的转录片段（文本、说话人、情绪、时间）。
update_segment	编辑一个片段的文本、情绪、说话人或跳过状态，并重新合成。
remix_video	重新渲染音频混音 / 字幕 / 唇形同步，无需重新配音。
download_video	将完成后的 MP4 保存到本地（仅限 stdio）。
get_download_url	获取可分享、有时效限制的 MP4 浏览器下载链接（通过 HTTP/web 使用此工具）。
get_subtitles	获取 SRT/VTT 字幕（任意内嵌语言）。
upload_to_youtube	将已完成的任务发布（或重试发布）到已连接的频道。
cancel_job	取消或删除任务。
list_languages	源语言和目标语言列表（17 种目标语言）。
get_quota	查看当前分钟用量和请求用量，以及套餐限额。

配音工具（create_dub、dub_youtube）接受可选的 (quality voice，默认)、chatterbox（情绪语音）或 elevenlabs（付费）。

4. 覆盖 API 基址（开发环境）

SPIMOV_API_BASE=http://localhost:8000/api/v1 spimov-mcp