# Perfboard Designer

An MCP server that has your AI agent lay out perfboard and stripboard circuits: it finds parts, writes the board, checks the wiring and hands back an editor link.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: MaurerKrisztian
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MaurerKrisztian/perfboard-designer/tree/HEAD/mcp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/perfboard-designer

## What it does

Run it locally over stdio or connect over HTTP. The agent gets a set of tools: search the part catalog, start a board of a given size, place parts and route wires, then run a check. The report catches loose leads, parts that overlap, supply rails shorted together, and on stripboard, pins joined by a strip or landing in a cut hole.

A project sits in memory under a `projectId`, so the agent sends the file once and then makes small edits. The file itself stays the source of truth: `get_project` returns it and any tool accepts a whole project instead of an id. Ask for the board as text or as a PNG, and `make_share_link` gives you a URL that opens it in the editor at https://perfboarddesigner.com/app/.

You need Node.js 22 or newer; `npx` pulls `perfboard-designer-mcp` on the first run. No account. Links point at the public editor unless you change `PERFBOARD_EDITOR_URL`. A project that fails validation will not get a share link while `allowErrors` is unset, so run `validate_project` and fix the errors first.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.perfboarddesigner.com/mcp`
- Environment variables: `PERFBOARD_EDITOR_URL`, `PERFBOARD_PROJECTS_URL`, `PERFBOARD_IMAGE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

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

2. **Platform CLI**
```bash
claude mcp add --env PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> --env PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> --env PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> --transport stdio mcp -- npx -y perfboard-designer-mcp
```
Replace <…> with your own values

### Codex

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

2. **Platform CLI**
```bash
codex mcp add mcp --env PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> --env PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> --env PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> -- npx -y perfboard-designer-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "url": "https://mcp.perfboarddesigner.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "perfboard-designer-mcp"
            ],
            "env": {
                "PERFBOARD_EDITOR_URL": "<PERFBOARD_EDITOR_URL>",
                "PERFBOARD_PROJECTS_URL": "<PERFBOARD_PROJECTS_URL>",
                "PERFBOARD_IMAGE_URL": "<PERFBOARD_IMAGE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "http",
            "url": "https://mcp.perfboarddesigner.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "perfboard-designer-mcp"
            ],
            "env": {
                "PERFBOARD_EDITOR_URL": "<PERFBOARD_EDITOR_URL>",
                "PERFBOARD_PROJECTS_URL": "<PERFBOARD_PROJECTS_URL>",
                "PERFBOARD_IMAGE_URL": "<PERFBOARD_IMAGE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add -e PERFBOARD_EDITOR_URL=<PERFBOARD_EDITOR_URL> -e PERFBOARD_PROJECTS_URL=<PERFBOARD_PROJECTS_URL> -e PERFBOARD_IMAGE_URL=<PERFBOARD_IMAGE_URL> mcp npx -y perfboard-designer-mcp
```
Replace <…> with your own values

## When to use it
- lay out a circuit on perfboard from a plain description
- look up a part and check its pins and package
- catch shorted rails and unconnected pins before building
- get a link to the board and edit it by hand
- compare a board against an intended netlist

## Example prompts
- Check the project in `projectId` and list wires with loose ends
- Add a capacitor next to the chip and re-check the connections

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [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

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