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:

{
  "mcpServers": {
    "mcp-three": {
      "command": "npx",
      "args": ["mcp-three"]
    }
  }
}

Supported File Formats

.gltf - GLTF JSON format
.glb - GLTF Binary format

Common Use Cases

Converting 3D Models for Web Apps: Transform GLTF/GLB files into optimized React components
Model Debugging: Inspect model structure and properties before integration
Performance Optimization: Generate instanced meshes and optimized textures
Animation Setup: Prepare models with proper bone layouts for animations

This project is built using the xmcp framework.

MCP Three