MCP Three
# MCP Three - 3D Model Processing Server
<a href="https://cursor.com/install-mcp?name=mcp-three&config=ew0KICAgICJ0eXBlIjogInN0ZGlvIiwNCiAgICAiY29tbWFuZCI6ICJucHgiLA0KICAgICJhcmdzIjogWw0KICAgICAgIi15IiwNCiAgICAgICJtY3AtdGhyZWUiDQogICAgXQ0KICB9"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add mcp-three MCP server to Cursor" height="32" /></a>
A Model Context Protocol (MCP) server specialized for working with 3D models, specifically GLTF/GLB files. This server provides tools to convert 3D models into React Three Fiber JSX components and analyze model structures.
## Features
- **GLTF/GLB to JSX Conversion**: Convert 3D models into reusable React Three Fiber components
- **Model Structure Analysis**: Inspect and debug 3D model hierarchies and properties
- **Performance Optimization**: Support for instancing, mesh simplification, and texture optimization
- **TypeScript Support**: Generate type-safe React components with proper TypeScript definitions
## Tools Available
### 1. `gltfjsx`
Converts GLTF/GLB 3D model files into declarative React (react-three-fiber) JSX components.
**Features:**
- TypeScript definitions generation
- Mesh and material instancing for performance
- Texture format conversion and optimization
- Mesh simplification
- Shadow casting/receiving setup
- Bone layout for animations
- Metadata preservation
### 2. `get-model-structure`
Analyzes and returns the structure of a GLTF/GLB model file as JSON. Useful for debugging complex models and understanding their hierarchy before conversion.
## Getting Started
Add this server to your MCP client configuration:
```json
{
"mcpServers": {
"mcp-three": {
"command": "npx",
"args": ["mcp-three"]
}
}
}
```
## Supported File Formats
- `.gltf` - GLTF JSON format
- `.glb` - GLTF Binary format
## Common Use Cases
1. **Converting 3D Models for Web Apps**: Transform GLTF/GLB files into optimized React components
2. **Model Debugging**: Inspect model structure and properties before integration
3. **Performance Optimization**: Generate instanced meshes and optimized textures
4. **Animation Setup**: Prepare models with proper bone layouts for animations
> This project is built using the [xmcp](https://xmcp.dev) framework.
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get-model-structure is for debugging and analysis by returning parsed JSON structure, while gltfjsx is for code generation by converting models into React components. There is no overlap in functionality, making it easy for an agent to choose the correct tool based on the task.
The tool names follow different conventions: get-model-structure uses kebab-case with a verb-noun pattern, while gltfjsx is a specific tool name without a clear verb. This minor deviation prevents a perfect score, but the names are still readable and descriptive enough for their functions.
With only 2 tools, the server feels thin for handling GLTF/GLB models, as it might lack operations like model validation, editing, or export. However, the tools cover core tasks of analysis and code generation, making it borderline appropriate but potentially incomplete for broader workflows.
The server covers two key aspects: model structure analysis and React component generation. However, there are notable gaps, such as no tools for model creation, updating, or deletion, and no support for non-React frameworks or basic file operations, which could limit agent capabilities in full model lifecycle management.