three.ws Scenes — Claude Code MCP server for 3D scenes
Turn a text description into a 3D diorama, export a built world, or browse saved scenes. Use it when you want an AI agent to assemble a scene from a short prompt.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio scene-mcp -- npx -y @three-ws/scene-mcpWhat three.ws Scenes does
The server turns a description of a world into a diorama plan with a mood, palette, ground, and individual prompts for positioned objects. build_world handles the full path in one call, from planning through object generation to export. Or split the work: create a plan with compose_scene, then pass forged objects to export_scene.
Export combines the objects into a glTF 2.0 file with named nodes, ground, and lighting. Use get_scene to retrieve a saved world by ID, or list_scenes to browse recent and featured dioramas. Objects that fail to forge are skipped while the remaining scene can still be exported. The server requires Node.js >= 20 and network access to https://three.ws; no API key is needed.
What it helps with
- turn a written scene idea into a diorama plan
- generate and export a 3D world in one call
- combine forged objects into a GLB scene
- retrieve a saved world by ID
- browse recent or featured dioramas
Example prompts for the agent
- Create a 3D diorama of a lighthouse on a rocky shore during a storm.
- Build and export a world with a neon alley, a food cart, and streetlights.
- Find the saved scene with ID
scene-id.
How to install three.ws Scenes
Platform CLI
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio scene-mcp -- npx -y @three-ws/scene-mcpReplace <…> with your own values
Platform CLI
codex mcp add scene-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/scene-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"scene-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/scene-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"scene-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/scene-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> scene-mcp npx -y @three-ws/scene-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about three.ws Scenes
How do I install three.ws Scenes in Claude Code?
Run claude mcp add scene-mcp -- npx -y @three-ws/scene-mcp. You need Node.js >= 20 and network access.
What does three.ws Scenes do?
It turns a text prompt into a diorama plan, can generate and export the full 3D world, and lets you browse saved scenes.
What does three.ws Scenes need to run?
It requires Node.js >= 20 and network access to https://three.ws, or a custom endpoint set with THREE_WS_BASE. No API key is required.
