VibeGen

VibeGen MCP

让 AI 驾驭实时生成艺术工作室：读取画布、调整参数、切换引擎。

VibeGen MCP 通过工作室的 HTTP API，将 AI 连接到正在运行的 VibeGen 生成艺术工作室。它会读取实时画布状态和所有参数，实时调整滑块和切换引擎，短暂高亮显示正在操作的控件，以 JSON 文件的形式保存、列出、读取和应用预设，并截取画布的 PNG 快照，让 AI 查看生成的作品。它还可以读取引擎源代码（GLSL 或 TypeScript），并写入新版本，使其热重载到画布中。

即使没有打开工作室标签页，它也能渲染文件：列出每个场景及其滑块、默认值和精选外观，并渲染 PNG、MP4，或包含歌曲的音频响应 MP4（与工作室的“Export the whole song”功能相同）。相同的请求始终会渲染出相同的像素。

将它指向托管工作室（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()	列出工作室 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)	列出所有场景及其精选外观；列出一个场景的滑块、默认值和外观；或将整个目录保存为 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（适用于单个项目）。

Claude Desktop

将相同的 mcpServers 配置块添加到 claude_desktop_config.json（Settings > Developer > Edit Config），然后重启 Claude Desktop。

使用托管工作室的最快方式：打开 vibedna.ai/studio，点击 Set up in your AI，然后将它提供的文件拖入 AI 聊天窗口。INSTALL.md 逐步介绍了手动配置方法。

配置

变量	默认值	说明
STUDIO_URL	http://localhost:3000	要驱动的 Studio API 主机
STUDIO_TOKEN	（空）	作为 x-studio-token 发送；仅当 Studio 强制要求时才需要
STUDIO_CHROME_ARGS	按操作系统选择	渲染工具使用的浏览器标志；如果默认设置无法调用 GPU，请设置此项
STUDIO_RENDER_TIMEOUT	1800	单次渲染的最长时间，单位为秒

渲染工具会在你本机的无头浏览器中打开 Studio 的 /embed 页面，并使用你的 GPU 进行渲染。在托管版 Studio 上，STUDIO_TOKEN 中需要提供 Ultra 令牌；自行运行的 Studio 始终允许使用这些工具。

若要实时查看更改，请使用 ?remote=1 打开 Studio（例如 http://localhost:3000/?remote=1）。

网络

除 check_for_update() 外，每次调用都会发送到 STUDIO_URL。check_for_update() 会向 https://vibedna.ai/api/mcp/latest?slug=vibegen 请求已发布的版本号，不会发送任何关于你的信息。

许可证

MIT，详见 LICENSE。版权所有 (c) 2026 VibeDNA。

支持：[email protected]