Skip to content
Back to search

copper

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 14 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/claynicholson/copper-kicad-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/claynicholson/copper-kicad-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/claynicholson--copper-kicad-mcp/badge.svg)](/listings/claynicholson--copper-kicad-mcp)

HTML

<a href="/listings/claynicholson--copper-kicad-mcp"><img src="/api/listings/claynicholson--copper-kicad-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

You need [KiCad 10](https://www.kicad.org/download/). Then pick one:

| You use | Do this | |---|---| | Windows, any AI app | Run `Copper-for-KiCad-1.1.1-Setup.exe` from the [latest release](https://github.com/claynicholson/copper-kicad-mcp/releases/latest) and tick your AI apps | | Claude Desktop | Double-click `copper-1.1.1.mcpb` from the [latest release](https://github.com/claynicholson/copper-kicad-mcp/releases/latest) | | Claude Code | The two plugin commands below | | Cursor, VS Code, Windsurf, Codex, Zed and others | `npx -y copper-kicad setup` (Node.js 18+), or [add to Cursor](https://cursor.com/install-mcp?name=copper&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvcHBlci1raWNhZCJdfQ%3D%3D) / [install in VS Code](https://vscode.dev/redirect/mcp/install?name=copper&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22copper-kicad%22%5D%7D) | | A terminal | The one-line installer below |

# Claude Code
claude plugin marketplace add claynicholson/copper-kicad-mcp
claude plugin install copper@copper
# Windows (PowerShell)
powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/claynicholson/copper-kicad-mcp/main/installer/install.ps1 | iex"
# macOS / Linux
curl -LsSf https://raw.githubusercontent.com/claynicholson/copper-kicad-mcp/main/installer/install.sh | sh

Windows is tested end to end. The macOS and Linux routes are new: if one fails, please [open an issue](https://github.com/claynicholson/copper-kicad-mcp/issues).

Setup finds KiCad, brings your libraries and settings along, connects your AI apps and makes a test call. It asks before each step and backs up everything it changes. To paste a config instead, Cursor, Claude Desktop and Windsurf take this entry ([docs/INSTALL.md](docs/INSTALL.md) has the others):

{ "mcpServers": { "copper": { "command": "npx", "args": ["-y", "copper-kicad"] } } }

`npx -y copper-kicad setup --demo` runs the setup page on a throw-away folder, so you can look first. If something does not work, `npx -y copper-kicad doctor` (or `copper doctor` after the Windows or one-line install) names the fix. More in [docs/INSTALL.md](docs/INSTALL.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 32 lines
  1. {
  2. "name": "copper",
  3. "owner": {
  4. "name": "Clay Nicholson",
  5. "url": "https://github.com/claynicholson"
  6. },
  7. "metadata": {
  8. "description": "Copper for KiCad — design real, orderable KiCad boards with AI."
  9. },
  10. "plugins": [
  11. {
  12. "name": "copper",
  13. "source": "./plugin",
  14. "description": "KiCad schematic + PCB design with real parts (LCSC/JLCPCB by default, any vendor by config), KiCad-verified edits, renders and fab output for any PCB fab. Includes the Copper MCP server and design skills.",
  15. "version": "1.1.1",
  16. "category": "Development",
  17. "tags": [
  18. "kicad",
  19. "pcb",
  20. "electronics",
  21. "eda",
  22. "jlcpcb",
  23. "lcsc",
  24. "mcp"
  25. ],
  26. "policy": {
  27. "installation": "AVAILABLE",
  28. "authentication": "ON_INSTALL"
  29. }
  30. }
  31. ]
  32. }
README.md · README · 113 lines · 2 findings marked
  1. <!-- mcp-name: io.github.claynicholson/copper -->
  2. # copper-kicad-mcp
  3. Copper connects your AI app to KiCad, so it can design real boards you can order: schematic, LCSC parts, PCB
  4. layout and routing, KiCad's own ERC and DRC, renders and JLCPCB fab files.
  5. [![npm](https://img.shields.io/npm/v/copper-kicad)](https://www.npmjs.com/package/copper-kicad)
  6. [![License: MIT](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
  7. ## Install
  8. You need [KiCad 10](https://www.kicad.org/download/). Then pick one:
  9. | You use | Do this |
  10. |---|---|
  11. | Windows, any AI app | Run `Copper-for-KiCad-1.1.1-Setup.exe` from the [latest release](https://github.com/claynicholson/copper-kicad-mcp/releases/latest) and tick your AI apps |
  12. | Claude Desktop | Double-click `copper-1.1.1.mcpb` from the [latest release](https://github.com/claynicholson/copper-kicad-mcp/releases/latest) |
  13. | Claude Code | The two plugin commands below |
  14. | Cursor, VS Code, Windsurf, Codex, Zed and others | `npx -y copper-kicad setup` (Node.js 18+), or [add to Cursor](https://cursor.com/install-mcp?name=copper&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImNvcHBlci1raWNhZCJdfQ%3D%3D) / [install in VS Code](https://vscode.dev/redirect/mcp/install?name=copper&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22copper-kicad%22%5D%7D) |
  15. | A terminal | The one-line installer below |
  16. ```sh
  17. # Claude Code
  18. claude plugin marketplace add claynicholson/copper-kicad-mcp
  19. claude plugin install copper@copper
  20. ```
  21. ```powershell
  22. # Windows (PowerShell)
  23. powershell -ExecutionPolicy Bypass -c "irm https://raw.githubusercontent.com/claynicholson/copper-kicad-mcp/main/installer/install.ps1 | iex"
  24. ```
  25. ```sh
  26. # macOS / Linux
  27. curl -LsSf https://raw.githubusercontent.com/claynicholson/copper-kicad-mcp/main/installer/install.sh | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 35 on GitHub
  28. ```
  29. Windows is tested end to end. The macOS and Linux routes are new: if one fails, please
  30. [open an issue](https://github.com/claynicholson/copper-kicad-mcp/issues).
  31. Setup finds KiCad, brings your libraries and settings along, connects your AI apps and makes a test call. It asks
  32. before each step and backs up everything it changes. To paste a config instead, Cursor, Claude Desktop and Windsurf
  33. take this entry ([docs/INSTALL.md](docs/INSTALL.md) has the others):
  34. ```json
  35. { "mcpServers": { "copper": { "command": "npx", "args": ["-y", "copper-kicad"] } } }
  36. ```
  37. <img src="docs/media/setup.gif" alt="The Copper setup page: find KiCad, bring your KiCad setup along, connect AI apps, make a test call" width="720">
  38. `npx -y copper-kicad setup --demo` runs the setup page on a throw-away folder, so you can look first. If something
  39. does not work, `npx -y copper-kicad doctor` (or `copper doctor` after the Windows or one-line install) names the
  40. fix. More in [docs/INSTALL.md](docs/INSTALL.md).
  41. ## What it does
  42. Ask for something like "Design a USB-C powered ESP32-C3 board with a status LED, 30 x 40 mm". Your AI then works
  43. through it the way an engineer would:
  44. - It connects pins to nets by name (`U1.PA9 → USB_DP`), never by coordinates.
  45. - It searches LCSC/JLCPCB for real parts (Basic parts first, live stock) and imports each part's symbol and
  46. footprint, plus its 3D model when EasyEDA has one.
  47. - KiCad's ERC and DRC re-run after every change, and each finding comes with a ready fix.
  48. - It places parts and routes the board: a staged router with length matching, differential pairs and width
  49. classes, copper pours, and Freerouting.
  50. - It looks at its work: schematic, layer and ray-traced 3D renders go back to the model.
  51. - It writes Gerbers, drill, BOM and placement files for JLCPCB (or PCBWay, OSH Park, generic), zipped.
  52. Copper has 31 tools and works with any MCP app and any model. The model is your AI app's: the Copper server never
  53. calls one.
  54. ## Boards made with Copper
  55. <table>
  56. <tr>
  57. <td width="33%"><img src="docs/media/boards/macropad-rp2040.jpg" alt="RP2040 Macropad, 3D render" width="100%"><br>RP2040 Macropad: nine hot-swap keys and a knob. 66 x 90 mm, 2 layers, 65 parts.</td>
  58. <td width="33%"><img src="docs/media/boards/rp2040-dpad-eink.jpg" alt="RP2040 D-pad e-ink board, 3D render" width="100%"><br>RP2040 D-pad E-ink: D-pad, e-ink FPC and IMU. 72 x 84 mm, 4 layers, 55 parts.</td>
  59. <td width="33%"><img src="docs/media/boards/stepper-g0.jpg" alt="Stepper G0 controller, 3D render" width="100%"><br>Stepper G0: a 12 V stepper controller on one board. 58 x 48 mm, 2 layers, 40 parts.</td>
  60. </tr>
  61. <tr>
  62. <td width="33%"><img src="docs/media/boards/esp32c3-usbc.jpg" alt="ESP32-C3 USB-C board, 3D render" width="100%"><br>ESP32-C3 USB-C: Wi-Fi and BLE on USB-C. 30 x 40 mm, 2 layers, 15 parts.</td>
  63. <td width="33%"><img src="docs/media/boards/usbc-powerbank.jpg" alt="USB-C power bank, 3D render" width="100%"><br>USB-C Power Bank: an IP5306 power bank with USB-C in. 50 x 24 mm, 2 layers, 22 parts.</td>
  64. <td width="33%"><img src="docs/media/boards/phone-breathalyzer.jpg" alt="Phone breathalyzer board, 3D render" width="100%"><br>Phone Breathalyzer: an alcohol sensor that plugs into a phone. 22 x 48 mm, 2 layers, 30 parts.</td>
  65. </tr>
  66. </table>
  67. All six pass KiCad 10's ERC and DRC with 0 errors and 0 unconnected items. Layer art and fab files (Gerbers,
  68. drill, BOM, placement) are on [coppereda.com](https://coppereda.com).
  69. ## Docs
  70. [Install](docs/INSTALL.md) · [Configuration](docs/CONFIG.md) · [Parts providers](docs/PROVIDERS.md) ·
  71. [Fab profiles](docs/FAB_PROFILES.md) · [KiCad compatibility](docs/COMPATIBILITY.md) ·
  72. [Architecture](docs/ARCHITECTURE.md) · [Changelog](CHANGELOG.md) · [Contributing](CONTRIBUTING.md) · [Security](SECURITY.md)
  73. ## Privacy
  74. Copper runs on your machine. Your designs stay there, and there is no telemetry. It goes online only to:
  75. - search and download parts: LCSC, JLCPCB and EasyEDA, with the jlcsearch.tscircuit.com mirror as a fallback
  76. - check for a newer KiCad (gitlab.com) during `setup` and `doctor`; `COPPER_NO_UPDATE_CHECK=1` turns that off
  77. - download Freerouting (GitHub) and a Java runtime (Adoptium), about 120 MB once, when you ask for autorouting
  78. - sign in to GitHub, if you link it without the GitHub CLI
  79. Installing fetches a little more: the `npx` launcher installs Pillow from PyPI if KiCad's Python lacks it, and the
  80. one-line installers fetch [uv](https://docs.astral.sh/uv/), a Python 3.12 build and Pillow.
  81. The MCP server and CLI never call a language model. The package also holds `copper_kicad.agent`, a chat sidecar for
  82. a separate desktop app; nothing in the server or CLI starts it.
  83. ## License
  84. [MIT](LICENSE). Copper is an independent project, not affiliated with KiCad, LCSC, JLCPCB or any other vendor named here.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.