Yukkurigen MCP server

YukkuriGen — AI から使う「ゆっくり解説」動画生成

台本（話者＋セリフの配列）を渡すと、MP4 が返る。こちらで音声を合成してから 本番レンダーを開始する（5クレジット・有料プラン）。output:"preview" なら 1クレジット・低解像度・20秒で、無料プランでも動くものが見られる。 人が編集画面で作ることは想定していない——あなたが自分の AI に頼み、その AI が ここを呼ぶ。

あなた「ゆっくり解説で、日本の年金制度の動画を作って」
  → AI が create_yukkuri_video を呼ぶ（数秒で jobId が返る）
  → AI が get_job で音声合成とレンダー開始を待ち、get_render で MP4 の完成を待つ
  → MP4 の URL が返る
あなた「もう少しゆっくり喋らせて」
  → AI が update_lines を呼び直す

直すのもこのサイトではなく、AI との会話で行う。

作例

台本は AI（Claude）が書いて MCP で渡し、返ってきた MP4 をそのまま載せている（人の手直し無し）。どちらも台本 22 行・約1分40秒。 図解カード・写真・章の見出し・強調テロップは、台本を書いた AI が行ごとに指定し（card / photo / chapter / emphasis）、 こちらはそれを画像にして焼いている。音声・字幕・立ち絵・BGM・効果音はこちらで入れる。

ずんだもん・四国めたん「コンビニコーヒーが安い本当の理由」

→ MP4 をダウンロード（720p・約100秒・音あり・7.3MB）

霊夢・魔理沙「寝る前のスマホが睡眠を壊す理由」

→ MP4 をダウンロード（720p・約100秒・音あり・5.1MB）

頼み方の例:

ずんだもんとめたんで、コンビニコーヒーが安い理由を1分半くらいで解説して。最後にチャンネル登録を呼びかけて。

AI が台本を書いて createyukkurivideo を呼び、get_render で完成した MP4 の URL と、 YouTube の概要欄に貼るクレジット（credits）が返る。作例のクレジット:

【使用素材】
音声: VOICEVOX:ずんだもん、VOICEVOX:四国めたん
立ち絵: 坂本アヒル 様
背景: いらすとや 様（https://www.irasutoya.com/）
BGM: DOVA-SYNDROME（https://dova-s.jp/）、こおろぎ 様
効果音: 効果音ラボ（https://soundeffect-lab.info/）
写真: Openverse（CC0・パブリックドメイン）
制作: YukkuriGen（https://yukkurigen.com/）

VOICEVOX の音声は「VOICEVOX:キャラ名」の表記が利用条件。動画を投稿するときは、この クレジットを概要欄に入れること（YukkuriGen から YouTube へ投稿した場合は自動で入る）。 写真は Openverse で CC0・パブリックドメインのものだけを使っている。

アカウントの無いまま呼ぶと、会員登録（無料・月10クレジット）の URL 付きで signup_required が返る。 ChatGPT・claude.ai のコネクタなら、つなぐ時に登録と許可の画面が開く。

つなぐ

ChatGPT・claude.ai（コネクタ）

コネクタの追加で、この URL を入れるだけ。鍵は要らない:

https://app.yukkurigen.com/api/mcp

YukkuriGen の許可画面が開くので「許可する」を押す（OAuth 2.1・PKCE・動的クライアント登録）。 つないだアプリは https://app.yukkurigen.com/settings/api-keys に「<アプリ名>（OAuth）」として出て、 そこから取り消せる。

鍵をヘッダーで渡すクライアント

まず鍵を取る（無料・月10クレジット）: https://app.yukkurigen.com/settings/api-keys

Claude Code

claude mcp add --transport http yukkurigen https://app.yukkurigen.com/api/mcp \
  -H "Authorization: Bearer $YUKKURIGEN_API_KEY"

チームで共有するなら、このリポジトリの .mcp.json をプロジェクトに置く。 鍵は環境変数 YUKKURIGENAPIKEY から読む（ファイルに鍵を書かない）。

Codex

~/.codex/config.toml に足す:

[mcp_servers.yukkurigen]
url = "https://app.yukkurigen.com/api/mcp"
bearer_token_env_var = "YUKKURIGEN_API_KEY"

export YUKKURIGEN_API_KEY=yg_live_...

鍵は環境変数から読むので、設定ファイルに書かない。

Gemini CLI

export YUKKURIGEN_API_KEY=yg_live_...
gemini extensions install https://github.com/yukkurigen/yukkurigen-mcp

このリポジトリの gemini-extension.json が読まれる。鍵は環境変数から読むので、 ファイルに書かない。

その他の MCP クライアント

エンドポイントは1つだけ:

POST https://app.yukkurigen.com/api/mcp
Authorization: Bearer <API key>

JSON-RPC 2.0 over HTTP。tools/list でツール一覧が取れる。 server.json は MCP レジストリ用のマニフェスト。

REST で直接叩く

curl -X POST https://app.yukkurigen.com/api/v1/agent/generate \
  -H "Authorization: Bearer $YUKKURIGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-first-video-sync" \
  -d '{"title":"テスト","script":[{"speaker":"reimu","text":"こんにちは"},{"speaker":"marisa","text":"よろしくだぜ"}]}'

これは同期の呼び出しで、音声合成とレンダー開始を待ってから返る（台本が長いと数十秒。 サーバの設定によっては、一定時間だけ待って終わらなければ 202 が返る）。 待っている途中で接続が切れても、サーバ側では生成と課金が進む。投げ直すときは同じ Idempotency-Key を付ける （同じ鍵なら、処理中は 409、終わっていれば最初の結果が返り、2本目は作られない）。 待たずに済ませるなら Prefer: respond-async を付ける。数秒で 202 と jobId / projectId が返る （サーバの設定によってはジョブにならず、同期で待ってから 200 が返る）:

Shortened. The full README is on GitHub.