@modelcontextprotocol/server-threejs

Exposes Three.js 3D scene objects (geometries, materials, meshes, lights, cameras) as MCP resources that LLM clients can query and manipulate. Implements a resource-based MCP server that maps Three.js scene hierarchy to a queryable interface, allowing remote clients to introspect scene state, object properties, and spatial relationships without direct WebGL access.

Registers MCP tools that allow LLM clients to create, modify, and delete Three.js objects (meshes, lights, cameras) through standardized tool-calling interfaces. Implements tool handlers that translate LLM function calls into Three.js API operations, with schema validation for geometry parameters, material properties, and transform operations.

Maintains bidirectional state synchronization between the Three.js scene and connected MCP clients, pushing scene updates (object creation, deletion, property changes) to clients and receiving commands from clients to modify the scene. Uses MCP notifications or polling mechanisms to keep client representations of the scene state consistent with server-side changes.

Automatically generates JSON schemas for Three.js geometry constructors and material properties, enabling MCP clients to understand valid parameters for creating and modifying 3D objects. Introspects Three.js class definitions to extract parameter names, types, and constraints, then exposes these schemas as MCP resources or tool definitions.

Exposes Three.js camera and viewport controls (position, rotation, field of view, aspect ratio) as MCP tools and resources, allowing LLM clients to adjust the viewing perspective of the 3D scene. Implements camera manipulation handlers that translate LLM commands into Three.js camera transformations and viewport updates.

Exports Three.js scenes to standard 3D file formats (glTF/glB, OBJ, FBX) or JSON representations that can be persisted, shared, or imported into other 3D tools. Implements serialization handlers that traverse the scene graph, extract geometry and material data, and write to disk or return as structured data.

Exposes Three.js lighting (ambient, directional, point, spot lights) and material properties (color, metalness, roughness, emissive, opacity) as MCP tools and resources. Implements handlers for modifying light intensity, color, position, and material parameters, with real-time updates to the scene rendering.

Provides MCP tools for querying scene structure and performing spatial analysis: finding objects by name or type, calculating bounding boxes, measuring distances between objects, detecting intersections, and traversing the scene hierarchy. Implements query handlers that use Three.js raycasting and bounding box calculations to answer spatial questions.