# 3d Texture Toolkit

> 3d Texture Toolkit is an open-source MCP server for design and media. Extract embedded PBR texture maps from local GLB files, entirely on your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux
- **Website:** https://www.3dtexturegenerator.com
- **Repository:** https://github.com/jiangshan118/3d-texture-toolkit-mcp
- **MCP Registry name:** io.github.JiangShan118/3d-texture-toolkit
- **Categories:** design and media
- **Listing updated:** 2026-11-16

## About

One local tool, extract_pbr_maps, takes the path to a GLB 2.0 file and writes the embedded material images to disk. Base color and normal images keep their original PNG, JPEG or WebP bytes, while the glTF metallic-roughness image is split into two grayscale PNGs: roughness from the green channel and metallic from the blue channel, with the material factors applied. An output folder defaults to one beside the model, and existing files are skipped unless overwrite is set. The result reports files written, maps skipped and warnings.

The server makes no network requests and uploads nothing. Limits are spelled out: external image URLs and buffer files are not read, KTX2 and Basis are not decoded, and texture transforms, alternate UV sets, occlusion and emissive maps are ignored. Files over 512 MiB or images over 100 million pixels are rejected. It needs Node.js 20 and is MIT licensed.

It is linked to a separate website that retextures GLB models with AI through Tripo, using credit packs rather than a subscription; that service is not part of this local server.

## Features

- **PBR map export:** Writes base color, normal, roughness and metallic images from a GLB.
- **Channel splitting:** Splits the packed metallic-roughness texture into two grayscale PNGs.
- **Lossless copies:** Base color and normal images are not recompressed.
- **Local only:** Makes no network requests and uploads no data.
- **Safe limits:** Rejects huge files and images.
- **Clear reporting:** Lists written files, skipped maps and warnings.

## Good for

- Pull texture images from a downloaded GLB model
- Prepare roughness and metallic maps for another engine
- Audit which maps a model actually embeds
- Batch extract textures from a folder of assets via an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add 3d-texture-toolkit -- npx -y 3d-texture-toolkit-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "3d-texture-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "3d-texture-toolkit-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "3d-texture-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "3d-texture-toolkit-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "3d-texture-toolkit": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "3d-texture-toolkit-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "3d-texture-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "3d-texture-toolkit-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "3d-texture-toolkit": {
      "command": "npx",
      "args": [
        "-y",
        "3d-texture-toolkit-mcp"
      ]
    }
  }
}
```

## Tools

- `extract_pbr_maps`: Extract embedded PBR texture images from a GLB file

## FAQ

### Does it upload my model?

No, processing is local and no network requests are made.

### What formats work?

GLB 2.0 with embedded images in buffer views or PNG, JPEG and WebP data URIs.

### Does it overwrite files?

Not by default; existing files are skipped unless overwrite is true.

### What licence?

MIT.

### Is 3d Texture Toolkit free?

Yes. 3d Texture Toolkit is open source, so you can use and self-host it for free.

### How do I add 3d Texture Toolkit to Claude Code?

Run this command in your terminal: claude mcp add 3d-texture-toolkit -- npx -y 3d-texture-toolkit-mcp

### What are the best alternatives to 3d Texture Toolkit?

The closest alternatives to 3d Texture Toolkit are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/3d-texture-toolkit
