Enables an AI client to build, edit, and render 3D scenes including rooms, nodes, materials, cameras, and snapshots.
Also known as vibebytes/vibe3d, @vibebyte/vibe3d-mcp
- Stars
- 2
- Tools
- 17
- Downloads, 30 days
- —
- Latest version
- 0.2.14
- Last commit
- Nov 3, 2026
- License
- Apache-2.0
What is vibe3d MCP?
vibe3d enables an AI client to build, edit, and render 3D scenes including rooms, nodes, materials, cameras, and snapshots. It exposes 17 tools, such as vibe3d_help, vibe3d_status, vibe3d_room.
Summary generated from the project's README
About vibe3d MCP server
Building and rendering 3D scenes through an AI client is what vibe3d enables. Developers can use this server to construct rooms, manage nodes, apply materials, and control cameras or snapshots. It operates by launching a local daemon that listens on the loopback address, making it a local setup that integrates with clients like Claude Desktop, Cursor, VS Code, and Claude Code.
To use the server, you must have Node.js version 20 or higher installed on your system. The server relies on an existing installation of Chrome, Chromium, or Edge to perform rendering tasks. While scene editing works without a browser, the rendering capability requires one of these engines to be available on your system path. You can manage specific environments using variables like VIBE3D_CHROME for browser selection or VIBE3D_HOME for the daemon data directory.
What you can do with it
- 1Constructing 3D environmentsAsk your AI client to create a new 3D room with specific dimensions and shapes.
- 2Managing multiple 3D projectsDirect the AI to switch between different room IDs to work on separate scenes.
Written from the project's README. Every use case is checked against a quote from it.
How to install vibe3d MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall vibe3d MCP in Claude Code
$ claude mcp add --env 'VIBE3D_TOKEN=<YOUR_VIBE3D_TOKEN>' vibe3d -- npx -y @vibebyte/vibe3d-mcpInstall vibe3d MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"vibe3d": {
"command": "npx",
"args": [
"-y",
"@vibebyte/vibe3d-mcp"
],
"env": {
"VIBE3D_TOKEN": "<YOUR_VIBE3D_TOKEN>"
}
}
}
}Install vibe3d MCP in VS Code
.vscode/mcp.json
{
"servers": {
"vibe3d": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@vibebyte/vibe3d-mcp"
],
"env": {
"VIBE3D_TOKEN": "<YOUR_VIBE3D_TOKEN>"
}
}
}
}Install vibe3d MCP in VS Code CLI
$ code --add-mcp '{"name":"vibe3d","type":"stdio","command":"npx","args":["-y","@vibebyte/vibe3d-mcp"],"env":{"VIBE3D_TOKEN":"<YOUR_VIBE3D_TOKEN>"}}'Install vibe3d MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"vibe3d": {
"command": "npx",
"args": [
"-y",
"@vibebyte/vibe3d-mcp"
],
"env": {
"VIBE3D_TOKEN": "<YOUR_VIBE3D_TOKEN>"
}
}
}
}Install vibe3d MCP in Codex
$ codex mcp add vibe3d --env 'VIBE3D_TOKEN=<YOUR_VIBE3D_TOKEN>' -- npx -y @vibebyte/vibe3d-mcpInstall vibe3d MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.vibe3d] command = "npx" args = ["-y", "@vibebyte/vibe3d-mcp"] [mcp_servers.vibe3d.env] VIBE3D_TOKEN = "<YOUR_VIBE3D_TOKEN>"
Install vibe3d MCP in Gemini CLI
$ gemini mcp add -s user -e 'VIBE3D_TOKEN=<YOUR_VIBE3D_TOKEN>' vibe3d npx -- -y @vibebyte/vibe3d-mcpInstall vibe3d MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"vibe3d": {
"command": "npx",
"args": [
"-y",
"@vibebyte/vibe3d-mcp"
],
"env": {
"VIBE3D_TOKEN": "<YOUR_VIBE3D_TOKEN>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @vibebyte/vibe3d-mcp 0.2.14 in an isolated container with no network and no keys. It answered and listed 17 tools.
vibe3d MCP tools 17
Read from the server with tools/listvibe3d_helpRead-only查参数契约:给 tool(+op) 返回该 op 的参数字段/必填/枚举/错误码与示例;不给 tool 则列出全部工具与 op
vibe3d_statusRead-only[status] 能力探测:渲染器是否就绪、能否出 ID 通道、快照上限与载荷上限|含 id-pass 支持;渲染或导入前先查一次
vibe3d_roomAction[room] 房间:建 / 列 / 切绑定 / 看摘要 / 关 / 时间线|op: [read] list use get timeline;[write] create close|必填见 params 描述,字段见 vibe3d_help {tool, op}
vibe3d_sceneAction[scene] 场景:取整份 / 摘要 / 查询节点 / 统计 / 拾取 / 体检 / 撤销重做 / 差分 / 导入导出 / 检查点 / 当前选中|op: [read] get summary query stats pick validate diff export checkpoints selection;[write] undo redo import checkpoint restore|必填见 params 描述,字段见 vibe3d_help {tool, op}|import 是整场景替换,仅用于初始化或回滚
vibe3d_nodeAction[node] 节点:建 / 改 / 删 / 克隆 / 读 / 换父 / 批量变换 / 阵列 / 吸附 / 编组 / 合并烘焙 / 按画面框拟合 / 导入模型|op: [read] get;[write] create update delete clone reparent transform array attach group merge fit_screen import|必填见 params 描述,字段见 vibe3d_help {tool, op}|create 平铺传 kind+shape+size,material 可省略(自动建)
vibe3d_materialAction[material] 材质:按预设建 / 局部改 / 贴图与 UV / 批量指派|op: create patch map assign|必填见 params 描述,字段见 vibe3d_help {tool, op}|create 收 {preset},id 由服务端生成;preset 任意描述词都收(如 matte-white 会归一到 concrete + 浅色),原名回读在 preset/presetNote;patch 用 baseColor(也接受 color 别名)/metalness/roughness/emissive/opacity
vibe3d_stageAction[stage] 舞台与环境:预设/曝光/后处理/三渲二;雾、背景、环境光、HDRI|op: set env|必填见 params 描述,字段见 vibe3d_help {tool, op}|set/env 的字段平铺在顶层(勿包成 stage:{…}):env 传 background/ambient/fog,颜色 [r,g,b,a],fog 是对象 {near,far}、关雾传 false
vibe3d_animationAction[animation] 程序化动画:定义轨道 / 播放 / 停止 / 清除 / 批量摆姿势 / 人形步态|op: define play stop clear pose gait|必填见 params 描述,字段见 vibe3d_help {tool, op}
vibe3d_fxAction[fx] 特效:粒子或光柱,建 / 删|op: create delete|必填见 params 描述,字段见 vibe3d_help {tool, op}|id 由服务端生成,不要复用已有 id
vibe3d_meshAction[mesh] 网格构造:布尔 / 管体 / 背板 / 车削 / 有机体 / 倒角 / 树 / 人体 / 贴花|op: boolean tube backdrop lathe organic bevel tree mannequin decal|必填见 params 描述,字段见 vibe3d_help {tool, op}|decal 用真字形/图片;color 用 [r,g,b,a] 或 '#RRGGBB'
vibe3d_assetAction[asset] 资产:解析 glTF / 上传贴图模型 / 列表 / 删除|op: [read] inspect list;[write] put delete|必填见 params 描述,字段见 vibe3d_help {tool, op}
vibe3d_cameraAction[camera] 机位:设置 / 保存命名机位 / 删除 / 像素投影与反投影|op: [read] project unproject;[write] set save delete|必填见 params 描述,字段见 vibe3d_help {tool, op}|set 平铺 p/target/fov,勿包成 camera:{…};save 用命名机位
Show all 17 toolsShow fewer tools
vibe3d_renderRead-only[render] 渲染:快照 / 多视角 / 单资产特写 / 像素取色 / ID 通道 / 序列帧|op: snapshot views node pick assert id_pass sequence video|必填见 params 描述,字段见 vibe3d_help {tool, op}|snapshot / views 前先 vibe3d_status 探能力
vibe3d_export_glbRead-only[export_glb] 导出 GLB(任务制,用 vibe3d_job 查进度)|拿到 jobId 后轮询 vibe3d_job.get 到 state=done(失败看 error)
vibe3d_jobAction[job] 导出任务:查询 / 列表 / 取消|op: [read] get list;[write] cancel|必填见 params 描述,字段见 vibe3d_help {tool, op}
vibe3d_open_editorRead-only[open_editor] 打开房间编辑器(默认弹窗)|返回 url 与 hint;open:false 只回链接
vibe3d_apply_opsAction[apply_ops] 原子批量 op(仅用于跨节点依赖;日常请用专用工具)|嵌套载荷包在同名字段 {op:"node.create",node:{…}} / {op:"env.set",env:{…}},不能平铺到 op 顶层(会校验失败);ops 传数组不是 JSON 字符串。逐条操作请用专用工具
Configuration
VIBE3D_TOKENSecretDaemon auth token. Prefer this over a command-line flag.
VIBE3D_CHROMEChrome or Chromium executable. Rendering needs a system browser.
VIBE3D_HOMEDaemon home directory
VIBE3D_ROOMRoom id bound when the server starts
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablevibebytes/vibe3d is public and reachablegithub.com/vibebytes/vibe3d ↗Pass
- Package names this repository as its source@vibebyte/vibe3d-mcp names vibebytes/vibe3d as sourcenpmjs.com/package/@vibebyte/vibe3d-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @vibebyte/vibe3d-mcpnpmjs.com/package/@vibebyte/vibe3d-mcp/v/0.2.14#provenance ↗Pass
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-03github.com/vibebytes/vibe3d ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @vibebyte/vibe3d-mcpPass
- No critical advisory in the package or its dependencies2 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubvibe3d
vibe3d is an MCP server for building and rendering 3D scenes. One command starts the protocol server, which launches the local daemon for you.
Requires Node.js >= 20 (same as the MCP TypeScript SDK v2). Licensed under Apache-2.0.
Identity
| Surface | Value |
|---|---|
| GitHub | github.com/vibebytes/vibe3d |
| npm | @vibebyte/vibe3d-mcp (and other @vibebyte/vibe3d-* packages) |
| MCP Registry | io.github.vibebytes/vibe3d |
Install
npx -y @vibebyte/vibe3d-mcp@latest
The daemon listens on loopback only (127.0.0.1 / localhost).
Client config:
{
"mcpServers": {
"vibe3d": {
"command": "npx",
"args": ["-y", "@vibebyte/vibe3d-mcp@latest"]
}
}
}
GUI apps (Cursor, Claude Desktop) often do not load interactive shell config (~/.zshrc, nvm hooks, etc.). A wrapper like bash -lc "nvm use …" usually fails on macOS: login bash does not load zsh’s nvm. Do not put version-manager wrappers in MCP config.
Keep @latest in the config: without a version tag npx reuses its cache and never picks up new releases, even after you reload the MCP server. A newer MCP also restarts an older local daemon on start.
Make the default node / npx on the PATH those apps actually use >= 20, then use the JSON above:
- Install Node.js 20+ with the official installer or Homebrew so the system
nodeis already 20+; or - If you use a version manager, set its default to 20+ and ensure its shims are on the non-interactive PATH the GUI inherits (for example Volta’s
~/.volta/bin).nvm alias default 20alone does not fix Cursor if nvm is only sourced in zsh.
Cursor
Use the default JSON above in .cursor/mcp.json or the user MCP config. If status stays Error, open MCP Output — a Node < 20 message means fix the default Node on the GUI PATH (options above), not the MCP JSON shape.
Claude Desktop
Same JSON in claude_desktop_config.json.
Claude Code
claude mcp add vibe3d -- npx -y @vibebyte/vibe3d-mcp@latest
VS Code
{
"servers": {
"vibe3d": {
"command": "npx",
"args": ["-y", "@vibebyte/vibe3d-mcp@latest"]
}
}
}
MCP Inspector
npx @modelcontextprotocol/inspector --cli npx -y @vibebyte/vibe3d-mcp@latest --method tools/list
Environment
| Variable | Purpose |
|---|---|
VIBE3D_HOME |
Daemon data directory |
VIBE3D_CHROME |
Chrome or Chromium executable used for rendering |
VIBE3D_ROOM |
Room bound when the process starts |
VIBE3D_MCP_LOG |
Set to 0 to disable mcp.log |
VIBE3D_RESTART_DAEMON |
Set to 1 (or pass --restart-daemon) to restart the local daemon every time the MCP process starts |
When the MCP process starts and finds a local daemon of a different version, it stops that daemon (SIGTERM, data is flushed) and starts a matching one. Restarting the MCP therefore picks up an upgraded daemon. Rooms live only in daemon memory unless it runs with --persist (VIBE3D_PERSIST=1), so restarting a non-persistent daemon discards its rooms. --url remote daemons are never touched.
Rendering uses a system Chrome, Chromium, or Edge. The package does not download a browser. Without one, scene editing still works and vibe3d_status reports that rendering is unavailable.
Support
| Platform | Status |
|---|---|
| macOS | Verified |
| Linux | Expected when Chrome or Chromium is on the default path. Not re-checked here |
| Windows | Not verified. Set VIBE3D_CHROME if you try it |
CLI parameters
The vibe3d command line and MCP share one capability spec. Field names are camelCase. The CLI shows them in kebab-case, so rotateStep is --rotate-step and withinBBox is --within-bbox.
Comma-separated text splits into the field's array or tuple: --tags a,b, --offset 1,0,0. A command that has both width and height also accepts --size 1280x720. Objects take JSON, or @file.
vibe3d node create r1 --shape box --size 1,2,3
vibe3d scene query r1 --material m_aaaaaaaa --parent root
vibe3d anim gait r1 @runner --style run
vibe3d help <command> prints the same descriptions as vibe3d_help. An unknown flag is an error.
Tools
The server exposes a small set of grouped tools. Each call passes op, for example vibe3d_room with op: "create". This keeps tools/list small. Unknown tool names come back as tool errors (isError) so the model can correct itself. Long renders and exports are jobs: poll vibe3d_job.
Multiple rooms and chats
One MCP process keeps one default room. While it has seen a single room, room tools may omit room_id; results marked "implicit" used that default. Once the process has seen a second room (or several chats share it), calls without room_id are rejected and list the candidates. Pass the room_id returned by your own create call on every call. An explicit room_id routes only that call and never changes the default. vibe3d_room {op:"use"} pins the default room when you know only one chat is active.
Diagnostics
npx -y @vibebyte/vibe3d-mcp@latest --doctor --json
This prints the Node version, daemon health, Chrome discovery, schema file, and version match. It does not start an MCP session.
Develop
See CONTRIBUTING.md. From this repository, with Node 20+:
CI=true pnpm install
pnpm --filter @vibebyte/vibe3d-editor build
pnpm --filter @vibebyte/vibe3d-daemon build
pnpm --filter @vibebyte/vibe3d-mcp build
pnpm install may ask to reinstall node_modules from scratch. CI=true accepts that prompt.
Security reports: SECURITY.md.
vibe3d MCP questions
How do I add vibe3d MCP to Claude Code?
Run claude mcp add --env 'VIBE3D_TOKEN=<YOUR_VIBE3D_TOKEN>' vibe3d -- npx -y @vibebyte/vibe3d-mcp in your terminal. Add --scope user to make it available in every project.
How do I add vibe3d MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does vibe3d MCP provide?
It exposes 17 tools, including vibe3d_help, vibe3d_status, vibe3d_room, vibe3d_scene, vibe3d_node.
What are the system requirements for vibe3d?
You need Node.js version 20 or higher to run the server.
Does the server provide its own web browser for rendering?
No, it uses an existing system installation of Chrome, Chromium, or Edge for rendering tasks.
How can I make sure the MCP server uses the latest version?
You should include @latest in your configuration to prevent npx from using a cached version.