Cuecaps

cuecaps-mcp

Claude Code、Cursor、Claude Desktop、または任意の MCP クライアントから、コンピューター上の動画や音声ファイルに字幕を付けられます。「talk.mp4をKaraokeスタイルで字幕化して、MP4をください」と頼めば、元のファイルと同じ場所に talk.captions.mp4 が生成されます。このサーバーは、お使いのマシン上のヘッドレス Chrome または Edge で Cuecaps スタジオ独自の書き出し処理を実行するため、同じ設定でスタジオから書き出したものと同じ仕上がりになります。プロジェクトがアカウントに同期されると、caption_video はスタジオで開けるリンクも返すため、単語を修正したり、スタイルを変更したりできます。

インストール不要：ホスト型サーバー

URL で MCP サーバーに接続するアプリは、インストールもキーも不要で https://cuecaps.com/mcp（Streamable HTTP）を利用できます。対応アプリは、claude.ai、スマートフォンとデスクトップの Claude アプリ、ChatGPT、Gemini CLI、Claude Code、Cursor です。list_styles と studio_link を使えるため、「スペイン語のTikTokにカラオケ風の字幕」のように説明するだけで、字幕の設定が済んだスタジオリンクを取得し、ブラウザーで仕上げられます。コンピューター上のファイルに直接字幕を付けるには、以下のパッケージを使ってください。

• claude.ai：Settings、Connectors、Add custom connector の順に選択し、https://cuecaps.com/mcp を貼り付けます。
• Claude Code：claude mcp add --transport http cuecaps https://cuecaps.com/mcp
• Gemini CLI：~/.gemini/settings.json に { "mcpServers": { "cuecaps": { "httpUrl": "https://cuecaps.com/mcp" } } } を追加します。

各クライアントのセットアップ方法：cuecaps.com/ai-assistants。

必要条件

• Node 22 以降。
• Google Chrome または Microsoft Edge。標準のインストール先にある必要があります。別のブラウザーを使う場合は CUECAPS_CHROME で指定します。
• cuecaps.com/account で取得したキー。エージェントアクセスは Creator または Pro プランに含まれます：cuecaps.com/pricing。

セットアップ

Claude Code

claude mcp add cuecaps --env CUECAPS_API_KEY=cck_… -- npx -y cuecaps-mcp

Claude Desktop と Cursor

Claude Desktop では Settings、Developer、Edit Config の順に選択するか、Cursor では ~/.cursor/mcp.json に、以下を MCP 設定として追加します。

{ "mcpServers": { "cuecaps": { "command": "npx", "args": ["-y", "cuecaps-mcp"], "env": { "CUECAPS_API_KEY": "cck_…" } } } }

cuecaps.com/account の Agent access カードでキーを作成し、そのキーを入力した状態の設定を表示できます。

ツール

ツール	キー	機能
list_styles	不要	10種類の字幕スタイルの ID、名前、見た目を表示します。
studio_link	不要	設定済みの状態で開くスタジオリンクを返します。すべてのプランで利用できます。
account_status	必要	プラン、今の期間に残っているクラウド利用分数、リセット日、エージェントによる字幕化がプランに含まれるかどうかを表示します。
transcribe	必要	ファイル内のすべての単語とその開始・終了時刻（秒）、および SRT テキストを取得します。ファイルは書き出しません。
caption_video	必要	ファイルに字幕を付け、結果を元のファイルと同じ場所に書き出します。

path 以外の入力はすべて省略可能です。字幕設定には、スタジオリンクと同じ名前を使います：style、words（1～10）、lines（1または2）、position（top、middle、bottom）、aspect（9:16、1:1、4:5、16:9）、lang（es などの言語コード。auto にするとクラウド文字起こしで言語を検出します）。各ツールのスキーマに有効な値が記載されています。

transcribe と caption_video では、以下も指定できます。

• engine：cloud は、プランのクラウド利用分数を使う ElevenLabs Scribe です。音楽、アクセント、90以上の言語に強く、残りの利用分数でファイル全体を処理できる場合はデフォルトで使用されます。device は、利用分数を消費しないデバイス上の Whisper です。初回実行時にモデル（132 MB）がダウンロードされます。結果には、使用したエンジン名が含まれます。
• keyterms：クラウド文字起こしで指定した表記を使う、最大100個の名前や単語です。

caption_video では、以下も指定できます。

• output：字幕を焼き込んだ mp4（デフォルト）、または字幕のみの透過オーバーレイとしての mov や webm、字幕ファイルの srt や vtt。
• resolution：720p、1080p（デフォルト）、1440p、4k。1440p と 4K は Pro で利用できます。
• fps：24、25、30（デフォルト）、50、60。
• out_path：代わりに書き出す、既存フォルダー内の絶対パスです。出力形式は拡張子で決まります。

例

list_styles

{}

[{ "id": "bold", "name": "Bold", "look": "Montserrat in capitals with a black outline, …" }, …]を返します。

studio_link

{ "style": "karaoke", "words": 4, "aspect": "9:16" }

{ "url": "https://cuecaps.com/studio?style=karaoke&words=4&aspect=9%3A16" }を返します。

account_status

{}

{ "plan": "creator", "minutes_left": 287.5, "resets": "2026-11-20", "agents": true }を返します。

transcribe

{ "path": "/Users/ana/clips/talk.mp4", "engine": "device" }

{ "words": [{ "text": "Greetings!", "start": 0.48, "end": 1.84 }, …], "srt": "1\n00:00:00,480 --> …", "engine": "device", "minutes_used": 0 }を返します。

caption_video

{ "path": "/Users/ana/clips/talk.mp4", "style": "karaoke", "aspect": "9:16" }

{ "file": "/Users/ana/clips/talk.captions.mp4", "duration": 17.17, "engine": "cloud", "minutes_used": 0.29, "studio_url": "https://cuecaps.com/studio#p=…" }を返します。 実行中、サーバーは進行状況を報告します：Opening、Transcribing、Rendering 42%、Saving。

出力ファイル

caption_videoは、入力ファイルと同じ場所に<name>.captions.<ext>を書き込みます。同名のファイルがすでに存在する場合、上書きされることはありません。次の実行では<name>.captions-2.<ext>に書き込み、その後は-3、-4と続きます。out_pathにも同じルールが適用されます。

studio_urlのスタジオリンクを開くと、CreatorおよびProで保存済みプロジェクトを開けます。動画自体はお使いのマシンに保存されるため、別のデバイスでリンクを開くと、スタジオからファイルの再指定を求められます。

設定

変数	用途
CUECAPS_API_KEY	ご利用のキー（cck_と32文字）。
CUECAPS_CHROME	ChromeまたはEdgeの実行ファイルへのパス。標準のインストール先にない場合に指定します。
CUECAPS_URL	Cuecapsのサイト。デフォルトはhttps://cuecaps.comです。

プライバシー

• 動画はお使いのマシンに保存されます。レンダリングはコンピューター上のブラウザーで行われます。
• クラウド文字起こしでは、スタジオと同様に圧縮された音声が送信され、文字起こし後に削除されます。engine: "device"では音声は送信されません。CreatorおよびProでは、他のすべてのプロジェクトと同様に、プロジェクトとその単語は引き続きアカウントに同期されます。
• キーが送信されるのはcuecaps.com/api/*へのリクエストのみです。URL、ログ、ファイルに含まれることはありません。
• 実行ごとに一時的なブラウザープロファイルを使用し、その後削除するため、Cookieやプロジェクトは残りません。

ライセンス

MITです。ソースはgithub.com/Pantheonn3D/cuecaps-mcpにあります。