# KerfScript

KerfScript is a Claude Code MCP server for writing, checking, and rendering parametric laser-cutting designs. It outputs SVG or DXF files.

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

## What it does

KerfScript gives an AI assistant tools for working with parametric laser-cutting designs written in KerfScript. It can consult the language reference and examples, inspect a design's settings and allowed values, then render the result as SVG or DXF with part dimensions, layers, and warnings. Measurements use millimetres, and text is drawn with the bundled Atkinson Hyperlegible font.

The hosted endpoint is `https://mcp.mylasertools.com/mcp`; it needs no account or API key. A local setup uses Node.js 20 or later with `@mylasertools/kerfscript-mcp`, keeping designs on the local machine. The server cannot read files or access the network. A design may contain up to 64,000 characters and 20 attached libraries; rendering stops at 100,000 steps, 100 parts, or 10 sheets. A successful render does not prove that parts fit, so a test piece is needed before cutting a new design.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.mylasertools.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http kerfscript https://mcp.mylasertools.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add mcp -- npx -y @mylasertools/kerfscript-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add mcp --url https://mcp.mylasertools.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add mcp -- npx -y @mylasertools/kerfscript-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://mcp.mylasertools.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@mylasertools/kerfscript-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://mcp.mylasertools.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mylasertools/kerfscript-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http mcp https://mcp.mylasertools.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add mcp npx -y @mylasertools/kerfscript-mcp
```

## When to use it
- write a parametric laser-cutting design in KerfScript
- check a design against the language reference and examples
- inspect design settings and their permitted ranges
- render a design as SVG or DXF
- review part sizes, layers, and render warnings

## Example prompts
- Write a parametric laser-cutting box in KerfScript and check it against the language reference.
- Find an example for this kind of construction, then list its settings and allowed values.
- Render this design as DXF and report its dimensions, layers, and warnings.

## Similar
- [OpenCalque](https://affpapa.org/en/nevibecode/mcp/opencalque.md) — MCP server · ★ 128 repo stars
- [Vectorize](https://affpapa.org/en/nevibecode/mcp/vectorize.md) — MCP server
- [homotope](https://affpapa.org/en/nevibecode/mcp/homotope.md) — MCP server · ★ 9 repo stars
- [Nestbolt sheet nesting](https://affpapa.org/en/nevibecode/mcp/nestbolt-sheet-nesting.md) — MCP server · ★ 19 repo stars
- [Aspicio](https://affpapa.org/en/nevibecode/mcp/aspicio.md) — MCP server · ★ 6 repo stars
- [sendcutsend](https://affpapa.org/en/nevibecode/skills/sendcutsend.md) — skill · 11300 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
