# threecrate-mcp

threecrate-mcp MCP server for Claude Code and Cursor handles 3D point clouds and meshes with cleaning and repair tools.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 53 repo stars
- Author: rajgandhi1
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/rajgandhi1/threecrate/tree/HEAD/threecrate-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/threecrate-mcp

## What it does

threecrate-mcp connects AI agents to the `threecrate` library for processing point clouds and meshes in PLY, PCD, XYZ, and CSV formats. The server provides tools to inspect scans, estimate normals, downsample point clouds, and reconstruct meshes.

Operations run inside a single workspace folder, and point clouds exceeding 50 million points are rejected. The server writes outputs to new files rather than overwriting inputs and returns summaries instead of raw point coordinates to save context space.

The server requires Python 3.10+ or the `uv` tool to run.

Setup

Run `claude mcp add threecrate-mcp -- uvx threecrate-mcp` in Claude Code.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add threecrate-mcp -- uvx threecrate-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from threecrate-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add threecrate-mcp -- uvx threecrate-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from threecrate-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "threecrate-mcp": {
            "command": "uvx",
            "args": [
                "threecrate-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from threecrate-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "threecrate-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "threecrate-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from threecrate-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add threecrate-mcp uvx threecrate-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from threecrate-mcp <command>

## When to use it
- clean up and repair a 3D scan for STL printing
- align two point clouds with ICP
- convert a point cloud into a mesh
- segment a plane from a point cloud

## Example prompts
- Clean up `scan.ply` and repair it for printing
- Align these two point clouds using ICP
- Turn this point cloud into a mesh using Poisson reconstruction

## Similar
- [cli-anything-cloudcompare](https://affpapa.org/en/nevibecode/skills/cli-anything-cloudcompare.md) — skill · 543 installs
- [3d-model-generation](https://affpapa.org/en/nevibecode/skills/3d-model-generation.md) — skill · 1500 installs
- [3D Visualizer](https://affpapa.org/en/nevibecode/mcp/3d-visualizer.md) — MCP server · ★ 23 repo stars
- [layer-3d](https://affpapa.org/en/nevibecode/skills/layer-3d.md) — skill · 5000 installs
- [scenario-rodin](https://affpapa.org/en/nevibecode/skills/scenario-rodin.md) — skill · 927 installs
- [scenario-sparc3d](https://affpapa.org/en/nevibecode/skills/scenario-sparc3d.md) — skill · 912 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
