Spimov Ai Video Clone Dubbing Mcp Server

spimov-mcp

Spimov 用の MCP サーバー — Claude Desktop／Claude Code／任意の MCP クライアントで動画を吹き替えます。

2 種類のトランスポート：

• 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 日あたりのリクエスト上限を使用します。

---

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 を使用し、完成した MP4 のクリック可能なブラウザー用ダウンロードリンクを取得するには get_download_url を使用してください。

3. ツール

ツール	目的
create_dub	ローカルファイルをアップロードし、吹き替えジョブをキューに登録します（stdio のみ）。
dub_youtube	YouTube URL をサーバー側で吹き替えます。チャンネルへの自動アップロードも任意で指定できます。
get_job_status	ジョブの状態を確認します（queued／processing／review／completed／failed）。
list_jobs	アカウントの最近のジョブを一覧表示します。
list_segments	ジョブの文字起こしセグメント（テキスト、話者、感情、タイミング）を取得します。
update_segment	1 つのセグメントのテキスト／感情／話者／スキップを編集し、再合成します。
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（標準音声、デフォルト）、chatterbox（感情表現のある音声）、または elevenlabs（有料）を指定できます。

4. API ベース URL を上書きする（開発用）

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