# kernelcad

Turns a plain-language part description into editable .kcad.ts source, checks the model, and prepares manufacturing artifacts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 33
- Author: w1ne
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/w1ne/kernelCAD-web
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/kernelcad

## What it does

kernelCAD sits above the OpenCASCADE kernel and is built for an agent to drive. The loop: a design brief becomes `.kcad.ts` source, that source evaluates into a model, the model goes through deterministic validation, gets revised if needed, and leaves as an export package. Feature history, diagnostics and variants live in the source text, so an agent can read and edit the model as code.

The server is hosted at `https://mcp.kernelcad.com/mcp`. Nothing runs on your machine and OpenCASCADE does not need to be installed. Anonymous use works; your client will prompt for OAuth sign-in when you want account features. The same account covers ChatGPT, Claude and the coding agents, and a saved model opens at the same `/p/<slug>` share link everywhere.

Checks go past the render. Assemblies such as the planetary stage or the bevel drive carry revolute mates and gear ratios derived from tooth counts, and `kernelcad validate --include-interference` looks for overlapping teeth. For printing there is a gate: `kernelcad dfm` checks wall thickness and unsupported overhangs. Prefer a local process? The second install command starts the server through `npx -y kernelcad`.

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

## Install

### Claude Code (native platform)

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

2. **Platform CLI**
```bash
claude mcp add kernelcad -- npx -y kernelcad
```

### Codex

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

2. **Platform CLI**
```bash
codex mcp add kernelcad -- npx -y kernelcad
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add kernelcad npx -y kernelcad
```

## When to use it
- get editable part source instead of a binary file
- check an assembly for overlapping teeth before printing
- run FDM print checks on a model
- build variants of one part from parameters
- hand a model to a human reviewer with its history

## Example prompts
- Build a hollow hex vase 150 mm tall with a 2 mm wall and save it as `.kcad.ts`
- Check the bevel gear pair for tooth interference with `evaluate_script`
- Export the part to STEP and tell me what the print checks say

## Similar
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221

---
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