orcadub-mcp-server

---

MCP 対応エージェント（Claude Code、Claude Desktop、Codex CLI、Cursor、Windsurf）に、あらゆる動画を別の言語に吹き替える機能を追加できます。ファイルをアップロードするか URL を渡し、OrcaRouter ゲートウェイを通じて orca/dub モデルにジョブを送信し、進捗を確認して、完成した MP4 をダウンロードします。

CLI の使い方

各操作は単発のサブコマンドです（常駐サーバーは不要です）。

export ORCADUB_API_KEY=sk-orca-...   # from https://www.orcarouter.ai/console

npx -y @orcadub/cli health
npx -y @orcadub/cli upload --path ./clip.mp4
npx -y @orcadub/cli create --source-lang en --target-lang ja \
  --url https://youtu.be/... --opt preserve_bgm=true
npx -y @orcadub/cli get --video-id <id>
npx -y @orcadub/cli download --video-id <id> --dest ./out.mp4

省略可能な create パラメーターには、繰り返し指定できる --opt key=val を使います（例： --opt watermark=false --opt resolution=1080p --opt glossary.OrcaDub=OrcaDub）。 結果は標準出力に JSON で出力され、エラーは標準エラー出力に出力され、終了コードは 0 以外になります。

サブコマンドを指定しない場合、同じバイナリが MCP stdio サーバーとして実行されます（npx -y @orcadub/cli）。

エージェント Skill をインストールする

dub-video Skill は、エージェントに、吹き替えを行うタイミング、課金対象のパラメーターのうち確認が必要なもの、アップロード → 作成 → ポーリング → ダウンロードのワークフローの実行方法を教えます。対話形式でインストールします。

npx -y @orcadub/cli skill install

ガイド付きインストーラーを開くと、まずバランスの取れた 8 行の ORCADUB ワードマークが表示され、その後、次の操作を行えます。

• 簡体字中国語または英語のインターフェースを選択します。システムのロケールに基づいて初期設定が選ばれます。
• 矢印キーで Project または Global のインストールを選択します。
• チェックボックスの一覧から、1 つ以上のプラットフォームを選択します。検出されたプラットフォームは先頭に表示され、あらかじめチェックされています。
• Space で切り替え、/ で絞り込み、a ですべて選択、n ですべて解除し、Enter で確定します。

Comet 対応の 33 プラットフォームのカタログに Hermes、OpenClaw、Command Code を加えた、計 36 のプラットフォームに対応しています。言語選択画面を省略するには、--lang zh または --lang en を使用します。無人セットアップやエージェントによるセットアップでは、対象を明示的に選択します。

# Current project
npx -y @orcadub/cli skill install \
  --platform claude --platform codex --scope project --lang en --yes

# User-wide Codex installation
npx -y @orcadub/cli skill install \
  --platform codex --scope global --lang zh --yes

検出されたプラットフォーム（何も検出されなかった場合はすべてのプラットフォーム）を受け入れてインストーラーを開かずに進めるには、--yes を使用します。装飾のない構造化出力には --json を使用します。色なしでインストーラーを実行するには、NO_COLOR を設定するか、TERM=dumb を使用します。既存のコンテンツと同一のものは変更されません。異なる Skill がすでに存在する場合は、--force を指定しない限り保持されます。Skill のインストールには、正規の orcadub-plugin リポジトリへのネットワークアクセスが必要ですが、ORCADUB_API_KEY は不要で、OrcaRouter への接続も行いません。

クイックスタート

claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

あとはエージェントに次のように依頼するだけです。「これを中国語に吹き替えてください：https://www.youtube.com/watch?v=…」

前提条件

OrcaRouter API キーが必要です。すべてのツール呼び出しで認証が行われます。

1. OrcaRouter コンソールで登録またはログインします。
2. トークン管理ページで API キーを作成します（sk-orca-... のような形式です）。
3. ORCADUB_API_KEY 環境変数を使ってキーを設定します（下記を参照）。

吹き替えジョブは、元動画の長さ 1 分あたりの料金が発生します。キーがなくてもサーバーは起動しますが、すべてのツール呼び出しでコンソールへのサインアップを促すリダイレクトが返されます。

インストール

Claude Code

claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

Claude Desktop

claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "orcadub": {
      "command": "npx",
      "args": ["-y", "@orcadub/cli"],
      "env": { "ORCADUB_API_KEY": "sk-orca-..." }
    }
  }
}

Codex CLI

codex mcp add orcadub --env ORCADUB_API_KEY=sk-orca-... -- npx -y @orcadub/cli

Cursor / Windsurf / その他の MCP ホスト

stdio MCP サーバーを起動するホストなら、同じ形式で使用できます。コマンドは npx、引数は ["-y", "@orcadub/cli"]、環境変数は ORCADUB_API_KEY です。Claude Code、Codex、Cursor、Windsurf 用のコピーしてすぐ使える設定ファイルは examples/ にあります。

Docker

linux/amd64 と linux/arm64 用のイメージは GHCR に公開されています：

docker pull ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest
claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- \
  docker run --rm -i -e ORCADUB_API_KEY -v "$PWD:$PWD" -w "$PWD" \
  ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest

または、ホストの JSON 設定を使用します：

{
  "mcpServers": {
    "orcadub": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "-e", "ORCADUB_API_KEY",
               "-v", "/path/to/videos:/work", "-w", "/work",
               "ghcr.io/continuum-ai-corp/orcadub-mcp-server:latest"],
      "env": { "ORCADUB_API_KEY": "sk-orca-..." }
    }
  }
}

注：dub_upload と dub_download はローカルパスの読み書きを行うため、アップロード元／ダウンロード先のディレクトリをマウントしてください（-v フラグ）。ツールに渡すパスは、コンテナ内で有効なものである必要があります。

ビルド済みバイナリ

リリースページからお使いのプラットフォーム用のバイナリをダウンロードし（checksums.txt で検証してください）、直接登録します：

# example: Linux amd64 via gh CLI
gh release download v0.1.0 -R Continuum-AI-Corp/orcadub-mcp-server \
  -p 'orcadub-mcp-server_*_linux_amd64' -O ~/bin/orcadub-mcp-server && chmod +x ~/bin/orcadub-mcp-server
claude mcp add orcadub -e ORCADUB_API_KEY=sk-orca-... -- ~/bin/orcadub-mcp-server

ソースから

git clone https://github.com/Continuum-AI-Corp/orcadub-mcp-server && cd orcadub-mcp-server && make build
# binary lands in bin/orcadub-mcp-server

設定

環境変数	必須	説明
ORCADUB_API_KEY	はい	OrcaRouter の sk-orca-... キーです。すべてのリクエストで Authorization: Bearer として送信されます。ゲートウェイはこのキーからワークスペースと請求情報を特定します。

ゲートウェイのアドレス（https://api.orcarouter.ai）はバイナリに固定されているため、ほかに設定する項目はありません。

ツール

ツール	説明
dub_health	ゲートウェイから orca/dub へのルーティングをエンドツーエンドで確認します。ジョブは作成されず、課金もされません。
dub_upload	ローカルの動画ファイルをアップロードし、dub_create 用の file_id を返します。64 MiB を超えるファイルは自動的に分割されます（最大 8 GiB）。
dub_create	吹き替えジョブを送信します（課金されます）。ソースには file_id または url のどちらか一方を指定します（YouTube と直接リンクはサーバー側で取得されます）。必須項目は source_lang、target_lang（auto は指定できません）、および file_id を使用する場合の video_name です。オプションでは、コンテンツプロファイル、用語集、翻訳スタイル、BGM の保持、リップシンク、透かし、解像度／比率などを指定できます。
dub_get	ジョブの状態を確認します。状態は整数の進捗率とともに queued → in_progress → completed | failed と遷移します。完了すると、レスポンスに content_url（Bearer 認証が必要な配信先。期限切れになりません）と job_id が含まれます。
dub_download	完了したジョブの MP4 をローカルパスに保存します（既存ファイルへの上書きは拒否されます）。

対応言語：en zh ja ko fr de es pt ru ar it hi tr th vi id bn pl nl uk fil el cs sv da no fi sk

例

一般的なエージェントとの会話：

ユーザー： これを中国語に吹き替えてください：https://www.youtube.com/watch?v=xxxx

エージェント： (source_lang=en、target_lang=zh、url=… で dub_create を実行) → ジョブがキューに追加される → (約 30 秒ごとに dub_get で状態を確認) → 完了 → (ローカルにダウンロードするか確認。既定の保存先はカレントディレクトリ) → (dub_download を実行) → 「./My-Video-zh.mp4 に保存しました。いつでも再ダウンロードできます：curl -H "Authorization: Bearer sk-orca-..." <content_url> -o out.mp4」

エージェントのプロンプトからツールを直接使用することもできます。例：dub_create {"source_lang":"en","target_lang":"zh","url":"https://…","glossary":{"OrcaRT":"OrcaDub Realtime"}}。

トラブルシューティング

症状	原因／対処法
ツール呼び出しで not authorized … www.orcarouter.ai/console が返される	ORCADUB_API_KEY が設定されていません。登録してキーをエクスポートし、セッションを再起動してください。
401	キーが無効、または期限切れです。OrcaRouter コンソールでキーを再発行してください。
402 insufficient_credit	OrcaRouter の残高を追加してください（分単位の課金です）。
429 free_quota_exceeded	無料枠の上限に達しました。
dub_get で task_not_exist が返される	この ID はこのゲートウェイ経由で作成されていません。dub_create が返した ID をそのまま使用してください。

開発

go build ./...
go test ./... -count=1

構成：cmd/（エントリーポイント）・internal/（HTTP クライアント、Skill インストーラー、ツールレイヤー、ワイヤー型）・npm/（GitHub Releases からプラットフォーム用バイナリをダウンロードする npx ランチャー）・server.json（MCP Registry マニフェスト）。

リリース

1. タグを付けます：git tag v0.1.0 && git push origin v0.1.0。
2. GitHub Actions が goreleaser を実行します。linux/darwin/windows × amd64/arm64 のバイナリ、アーカイブ、チェックサムがリリースに追加されます。
3. npm-publish ジョブがタグのバージョンを npm/package.json に設定し、@orcadub/cli を npm に公開します（リポジトリのシークレット NPM_TOKEN が必要です）。
4. レジストリジョブが同じタグのバージョンを server.json に設定し、MCP Registry に公開します。

ライセンス

MIT