Easyeda Pro MCP

EasyEDA Pro MCP

Connect Claude, Codex, Cursor, VS Code, Antigravity, and other Model Context Protocol (MCP) clients to the live EasyEDA Pro project already open on your machine.

Independent open-source MCP bridge for live schematic and PCB workflows in EasyEDA Pro.

Quick Start · AI Client Setup · Tools · Troubleshooting · Releases

Key Features

• Live schematic & PCB introspection — Give AI agents structured access to your open EasyEDA Pro project without screenshots or manual exports.
• Circuit tracing & verification — Trace nets and component pins, find unconnected pins, and run programmatic assertions (pull-ups/downs, decoupling capacitors, USB-C 5.1k CC paths).
• Native PCB DRC rule management — Read active design rules, saved profiles, and net/region tables, preview changes safely, and apply confirmed rule updates with readback verification.
• Editor navigation & fabrication exports — Focus components or regions directly in EasyEDA Pro and export BOM, Netlist, Gerber, and PDF files.
• Local & read-first by default — Runs locally over stdio and ws://127.0.0.1:8765. Inspection is read-only; mutating actions require explicit human confirmation.

Requirements

• Node.js 20 or newer
• EasyEDA Pro 2.3.0 or newer
• An MCP-compatible AI client (Claude Code, Codex, Claude Desktop, Cursor, VS Code, Antigravity, Windsurf, etc.)

Getting Started

EasyEDA Pro MCP has two local parts: the EasyEDA Pro Extension (.eext) inside the editor and the MCP Server (@vlabsoftware/easyeda-pro-mcp) launched by your AI client.

1. Automatic Setup (Fastest — No Git Clone)

Run one command in your terminal:

npx -y @vlabsoftware/easyeda-pro-mcp setup

This automatically detects and configures installed AI clients (Claude Desktop, Cursor, VS Code, Antigravity, Windsurf, Claude Code, Codex) with platform-safe commands and exports easyeda_mcp_bridge.eext to your ~/Downloads folder (or current directory).

Building from source instead?

git clone https://github.com/VLab-Software/easyeda_mcp.git

cd easyeda_mcp npm install npm run setup:local npm run setup:clients # Optional: points detected AI clients to this local build

This builds dist/index.js, build/dist/easyeda_mcp_bridge.eext, and build/dist/easyeda-pro-mcp.mcpb.

2. Install the EasyEDA Pro Extension

1. In EasyEDA Pro, open Extensions Manager and import the exported easyeda_mcp_bridge.eext *(or download easyeda_mcp_bridge.eext from Releases)*.
2. Enable Allow interactive with external for EasyEDA MCP Bridge.
3. Open your schematic or PCB project *(if needed, click MCP Bridge -> Reconnect in the top toolbar)*.

3. Or Add the MCP Server Manually / 1-Click

If you skipped npx -y @vlabsoftware/easyeda-pro-mcp setup, use a 1-click badge above or add the standard `npx` config below:

{

"mcpServers": { "easyeda-pro": { "command": "npx", "args": ["-y", "@vlabsoftware/easyeda-pro-mcp"] } } }

Windows JSON note: In GUI clients on Windows, use "command": "cmd", "args": ["/c", "npx", "-y", "@vlabsoftware/easyeda-pro-mcp"] so npx.cmd spawns cleanly.

Claude Code

Run in your terminal:

claude mcp add --scope user easyeda-pro -- npx -y @vlabsoftware/easyeda-pro-mcp

Codex

Run in your terminal:

codex mcp add easyeda-pro -- npx -y @vlabsoftware/easyeda-pro-mcp

Claude Desktop

• 1-Click Bundle: Download easyeda-pro-mcp.mcpb and double-click it to install in Claude Desktop.
• Manual JSON: Or add the standard config above to claude_desktop_config.json, then fully quit and reopen Claude Desktop:
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json *(use "command": "cmd", "args": ["/c", "npx", "-y", "@vlabsoftware/easyeda-pro-mcp"])*

Cursor

Click [Install in Cursor](https://cursor.com/install-mcp?name=easyeda-pro&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB2bGFic29mdHdhcmUvZWFzeWVkYS1wcm8tbWNwIl19), or add the standard config above to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project) and refresh servers in Cursor Settings -> MCP.

VS Code (GitHub Copilot)

Click [Install in VS Code](https://vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522easyeda-pro%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540vlabsoftware%252Feasyeda-pro-mcp%2522%255D%257D), or add to .vscode/mcp.json (or Command Palette -> `MCP: Open User Configuration`) and open Copilot Chat (Agent mode):

{

"servers": { "easyeda-pro": { "type": "stdio", "command": "npx", "args": ["-y", "@vlabsoftware/easyeda-pro-mcp"] } } }

Antigravity & Windsurf

• Antigravity: Run npx -y @vlabsoftware/easyeda-pro-mcp setup --client antigravity (or add the standard config to ~/.gemini/config/mcp_config.json), then click Refresh in Additional Options (`...`) -> MCP Servers.
• Windsurf: Run npx -y @vlabsoftware/easyeda-pro-mcp setup --client windsurf (or add the standard config to ~/.codeium/windsurf/mcp_config.json), then refresh MCP servers in Cascade settings.

Your First Prompts

Verify that the bridge is connected and sees your open document:

Run easyeda_doctor and check whether the EasyEDA Pro bridge is healthy.

Once connected, try real hardware engineering workflows:

Inspect the open schematic with easyeda_schematic_snapshot and list any unconnected pins.

Verify USB1 with easyeda_verify_connections: check that CC1 and CC2 each have a 5.1k resistor to GND and VBUS is decoupled to GND.

Read the active PCB design rules with easyeda_get_drc_rules and summarize track width, via size, and clearance limits.

More examples: [Practical Workflows](https://vlabsoft.org/easyeda_mcp/workflows)

Available Tools (32)

Full parameter schemas and examples: [Tools Reference](https://vlabsoft.org/easyeda_mcp/tools) · [DRC Rule Editing](https://vlabsoft.org/easyeda_mcp/drc-rules)

Documentation

<summ