VibeGen

VibeGen MCP

AI がライブのジェネレーティブアートスタジオを操作できるようにします。キャンバスを読み取り、ノブを動かし、エンジンを切り替えます。

VibeGen MCP は、スタジオの HTTP API を通じて、AI を起動中の VibeGen ジェネレーティブアートスタジオに接続します。ライブキャンバスの状態とすべてのパラメーターを読み取り、スライダーを動かしたり、エンジンをリアルタイムで切り替えたりしながら、操作中のコントロールを短時間ハイライト表示します。プリセットを JSON ファイルとして保存、一覧表示、読み込み、適用できるほか、キャンバスの PNG スナップショットを撮影して、AI が生成したものを確認できるようにします。また、エンジンのソース（GLSL または TypeScript）を読み込み、キャンバスにホットリロードされる新しいバージョンを書き込むこともできます。

スタジオのタブを開かずにファイルをレンダリングすることもできます。スライダー、デフォルト値、厳選されたルックを含むすべてのシーンを一覧表示し、PNG、MP4、または曲を含むオーディオリアクティブ MP4（スタジオの「曲全体をエクスポート」と同じもの）をレンダリングできます。同じリクエストでは、常に同じピクセルがレンダリングされます。

ホストされたスタジオ（https://studio.vibedna.ai、vibedna.ai/studio からアクセス）または独自のインスタンスを指定してください。アートはブラウザー上で、独自の GPU を使ってレンダリングされます。利用できる機能はスタジオのプランによって異なります。エンジンのソースを書き込むには、スタジオが受け入れるトークンが必要です。

ホームページ：https://vibedna.ai/store/vibegen

ツール（17）

ツール	機能
get_state()	エンジン ID、すべてのパラメーター値、スキーマ、適用済みレシピ
set_params(params)	パラメーターの一部を更新し、ライブで適用
set_engine(engine_id)	エンジンを切り替え
highlight_params(keys)	指定したスライダーを短時間点滅表示
list_saves()	スタジオの保存フォルダーにあるプリセット JSON ファイルを一覧表示
read_save(rel_path)	プリセットを読み込み
write_save(rel_path, content)	プリセットを書き込み
apply_save(rel_path)	プリセットをライブスタジオに読み込み
read_engine_source(engine_id)	エンジンのソースを読み込み
write_engine_source(engine_id, code)	エンジンのソースを置き換え。スタジオでホットリロードされます
snapshot_canvas(save_to, timeout_seconds)	ライブキャンバスを PNG として撮影
list_catalog(scene, save_to)	すべてのシーンと厳選されたルック、1 つのシーンのスライダー・デフォルト値・ルック、またはカタログ全体を JSON ファイルに出力
render_still(engine_id, out_path, ...)	スタジオのタブを開かずにシーンを PNG で出力
render_video(engine_id, out_path, ...)	シーンを MP4 で出力（最大 120 秒、最大 4096 px）
render_song(engine_id, song_path, out_path, ...)	曲を含むオーディオリアクティブ MP4：音楽ノブ、オートメーションレーン、開始位置と終了位置のカット
check_for_update()	新しいバージョンが公開されているかどうかと、更新方法を確認
vibedna_info()	この MCP の機能と接続先のスタジオを確認

インストール

git clone https://github.com/marstudio360/vibegen-mcp
cd vibegen-mcp
pip install -r requirements.txt

Python 3.10 以降が必要です。レンダリングツールには Playwright も必要です（任意）：pip install playwright && playwright install chromium。

Claude Code

claude mcp add vibegen --scope user -e STUDIO_URL=http://localhost:3000 -- python /absolute/path/to/vibegen-mcp/server.py

または、プロジェクトの .mcp.json に追加します。

{
  "mcpServers": {
    "vibegen": {
      "command": "python",
      "args": ["/absolute/path/to/vibegen-mcp/server.py"],
      "env": {
        "STUDIO_URL": "http://localhost:3000",
        "STUDIO_TOKEN": ""
      }
    }
  }
}

Cursor

同じ mcpServers ブロックを ~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1 つのプロジェクト）に追加します。

Claude Desktop

同じ mcpServers ブロックを claude_desktop_config.json（「設定」>「開発者」>「設定を編集」）に追加し、Claude Desktop を再起動します。

ホストされたスタジオを使う最短の方法：vibedna.ai/studio を開き、AI でセットアップをクリックして、表示されたファイルを AI とのチャットにドロップします。INSTALL.md では、手動で設定する方法を手順ごとに説明しています。

設定

変数	デフォルト	説明
STUDIO_URL	http://localhost:3000	操作するスタジオの API ホスト
STUDIO_TOKEN	(empty)	x-studio-token として送信されます。スタジオでトークンが必須の場合にのみ必要です
STUDIO_CHROME_ARGS	picked per OS	デフォルト設定で GPU を使用できない場合に、レンダーツールで使用するブラウザーフラグ
STUDIO_RENDER_TIMEOUT	1800	1 回のレンダリングに許可される最長時間（秒）

レンダーツールは、マシン上のヘッドレスブラウザーでスタジオの /embed ページを開き、GPU でレンダリングします。ホスト型のスタジオでは STUDIO_TOKEN に Ultra トークンが必要ですが、自分で実行するスタジオでは常に使用できます。

変更をリアルタイムで確認するには、?remote=1 を付けてスタジオを開いてください（例：http://localhost:3000/?remote=1）。

ネットワーク

公開済みのバージョン番号を取得するため、check_for_update() は例外的に https://vibedna.ai/api/mcp/latest?slug=vibegen にリクエストします。あなたに関する情報は送信されません。それ以外のすべての呼び出しは STUDIO_URL に送信されます。

ライセンス

MIT。詳細は LICENSE をご覧ください。Copyright (c) 2026 VibeDNA.

サポート：[email protected]