threejs-scene-mcp-server

MCP server that auto-injects RAPIER physics + OrbitControls boilerplate into Three.js scenes, plus high-level object spawning helpers.

Tools

| Tool | What it does | |------|--------------| | scene_assemble | Wraps your scene code with RAPIER + OrbitControls boilerplate. Returns assembled code → feed to Three.js 3D Viewer. | | scene_template | Returns a complete named scene (physics_sandbox, character_stage, arena, space) ready to render. | | scene_spawn | Generates a single object snippet (shape + physics + material) to include in your scene code. | | scene_materials | Returns a ready-to-use material palette snippet. |

Workflow

Claude calls scene_spawn(...) → gets snippet
Claude calls scene_assemble(snippet) → gets full code
Claude passes assembledCode to Three.js 3D Viewer tool → renders

Install & Run

pnpm install
pnpm build
pnpm start

Claude Desktop Config (claude_desktop_config.json)

{
  "mcpServers": {
    "threejs-scene": {
      "command": "node",
      "args": ["/path/to/threejs-scene-mcp/dist/index.js"]
    }
  }
}