home / mcp / mcp three - 3d model processing server
Provides GLTF/GLB to JSX conversion, model structure analysis, and TS-ready React components for web 3D apps.
Configuration
View docs{
"mcpServers": {
"basementstudio-mcp-three": {
"command": "npx",
"args": [
"mcp-three"
]
}
}
}You run an MCP server focused on 3D models to convert GLTF/GLB files into reusable React Three Fiber JSX components and to inspect model structures. This makes it easier to build performant, type-safe web 3D apps by producing ready-to-use components and by revealing how a model is structured before you integrate it into your project.
You connect to the MCP Three server through your MCP client configuration. Once connected, you can convert GLTF/GLB models into declarative React Three Fiber components, analyze model structures to understand hierarchies, and enable performance optimizations such as instancing and texture improvements. Begin by pointing your client at the mcp-three server and then use the conversion tool to generate TS-ready React components that preserve mesh, material, and animation metadata.
Prerequisites: Node.js (and npm) installed on your development machine.
Install and run the MCP Three server via your MCP client configuration. If you are adding it to your client, include the following configuration snippet in your MCP client settings.
{
"mcpServers": {
"mcp-three": {
"command": "npx",
"args": ["mcp-three"]
}
}
}Supported file formats include GLTF (.gltf) and GLB (.glb). Use MCP Three to convert these models into optimized React components with TypeScript definitions, inspect model structures via a structure analyzer, and prepare models with bone layouts for animations.
Common use cases include converting models for web apps, debugging model hierarchies, and applying performance optimizations like mesh instancing and texture optimization. You can also set up animation-ready models with proper bone layouts.
The server exposes two main tools: - gltfjsx: converts GLTF/GLB files into declarative react-three-fiber JSX components with TypeScript support, material/mesh instancing, texture optimization, and animation metadata. - get-model-structure: analyzes a GLTF/GLB and returns its structure as JSON for debugging complex models.
Converts GLTF/GLB files into declarative react-three-fiber JSX components with TypeScript definitions, mesh/material instancing, texture optimization, bone layouts for animations, and preserved metadata.
Analyzes a GLTF/GLB file and returns its structural JSON representation to help debug hierarchies and properties before conversion.