https://github.com/basementstudio/mcp-three
https://github.com/basementstudio/mcp-three
Last synced: 10 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/basementstudio/mcp-three
- Owner: basementstudio
- Created: 2025-07-12T20:28:22.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-12T21:12:04.000Z (11 months ago)
- Last Synced: 2025-08-09T10:43:38.110Z (10 months ago)
- Language: TypeScript
- Size: 85.9 KB
- Stars: 12
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# MCP Three - 3D Model Processing Server
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.