# MeshMend

> MeshMend is a free MCP server for manufacturing. Check and repair STL and 3MF meshes locally, without your files leaving your machine. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://mesh-mend.pages.dev
- **Repository:** https://github.com/keith-cy/meshmend-mcp
- **MCP Registry name:** io.github.Keith-CY/meshmend-mcp
- **Categories:** manufacturing, design and media
- **Listing updated:** 2026-11-15

## About

Before sending a model to the slicer, an assistant can open the file on your computer and say what is wrong with it: holes, flipped faces, inside-out shells, non-manifold edges or duplicate triangles. check_mesh is read-only and ends with a verdict from a trial repair done in memory (ok, repairable, partly_repairable or needs_manual_review), so you learn whether an automatic fix will work before anything is written.

repair_mesh removes duplicate and zero-area faces, makes face winding consistent, turns inside-out shells outward and, only if requested, caps flat holes up to a span you set (20 mm by default). It writes a new binary STL in millimetres next to the original, using .repaired.stl and numbered suffixes rather than overwriting. convert_3mf_to_stl applies build transforms and units and exports a binary STL.

The server runs locally over stdio, reads and writes only the files you name, makes no network requests and has no telemetry. It needs Node.js 18 or later and ships as an npm package and a one-click bundle for Claude Desktop. The same mesh code powers a free in-browser STL repair tool, and the author is candid that complex non-manifold geometry, self-intersections and wall thickness still need a model editor.

## Features

- **Mesh health check:** check_mesh counts triangles and shells and lists every problem, with a repairability verdict.
- **Conservative repair:** repair_mesh fixes duplicates, winding and inside-out shells; hole filling is opt-in.
- **3MF conversion:** convert_3mf_to_stl applies build transforms and units and writes a binary STL.
- **Originals preserved:** Output goes to a new file and never overwrites the input.
- **Fully local:** No network requests and no telemetry.

## Good for

- Find out why a slicer reports holes in a model
- Repair a bracket STL before printing
- Convert a 3MF project to STL in millimetres
- Check whether a file is watertight from an assistant chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add meshmend-mcp -- npx -y https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "meshmend-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshmend-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "meshmend-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshmend-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "meshmend-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb"
      ]
    }
  }
}
```

## Tools

- `check_mesh`: Report size, triangles, shells and problems with a repairability verdict.
- `repair_mesh`: Repair a mesh and write a new binary STL.
- `convert_3mf_to_stl`: Convert a 3MF file to a binary STL in millimetres.

## FAQ

### Do my files leave my computer?

No. The server runs locally, reads only the files you name and makes no network requests.

### Will it overwrite my original?

No. Results go next to the input as a new file, and the input can never be the output.

### Can it fix every broken STL?

No. Complex non-manifold structures, overlaps and self-intersections need a model editor.

### What do I need to run it?

Node.js 18 or later, via npx or the Claude Desktop bundle.

### Is MeshMend free?

Yes. MeshMend is free to use.

### How do I add MeshMend to Claude Code?

Run this command in your terminal: claude mcp add meshmend-mcp -- npx -y https://github.com/Keith-CY/meshmend-mcp/releases/download/v0.1.0/meshmend-mcp-0.1.0.mcpb

### What are the best alternatives to MeshMend?

The closest alternatives to MeshMend 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.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/meshmend
