Easyeda Pro Mcp

io.github.VLab-SoftwarePublished by GitHub account VLab-Softwarev1.0.2Updated Nov 3, 2026

MCP server and EasyEDA Pro extension bridge for live project assistance.

VerifiedSTDIODesktop onlyFiles & StorageDeveloper Tools

Overview

AI-generated overview

Bridges an AI assistant to the live EasyEDA Pro project open on your machine for schematic and PCB inspection, verification, DRC rules and exports.

What you can do
  • Check bridge health, live status, current context and selection
  • Inspect and search schematics: snapshots, components, pins, nets and library parts
  • Trace nets and components, find unconnected pins and verify circuit assertions
  • Review PCB layout: run DRC, list layers and components, check routing, highlight nets, read and prepare DRC rule edits
  • Navigate to components or regions, zoom the board, and export CPL, BOM, netlist, Gerber and PDF
  • Run confirmed actions such as save, import changes, autoroute, autolayout and DRC rule edits
When to use it
Useful when you want an assistant to review an open EasyEDA Pro schematic or PCB without screenshots or manual exports: tracing nets, checking pull-ups, decoupling or USB-C CC paths, reading design rules, or producing fabrication files.
Requirements
Runs locally over stdio and needs Node.js 20 or newer, EasyEDA Pro 2.3.0 or newer with the bridge extension installed and external interaction allowed, and an MCP-compatible client. Optional EASYEDA_MCP_WS_HOST and EASYEDA_MCP_WS_PORT default to 127.0.0.1 and 8765.
Before you install
Inspection is read-only, but confirmed actions can save, import changes, autoroute, autolayout and edit DRC rules in your open project; these require explicit human confirmation. The setup command rewrites configuration files of detected AI clients, and exports write files such as Gerber, BOM and PDF.

Installation

In SourceWeft

  1. Open Easyeda Pro Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

[CI] [npm] [Release] [License] [Node] [Platforms] [Sponsor]

[Install in Cursor] [Install in VS Code] [Claude Desktop .mcpb] [EasyEDA Extension .eext]

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

[Demo showing EasyEDA Pro with the MCP Bridge workflow in action]

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:

bash
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?
bash
git clone https://github.com/VLab-Software/easyeda_mcp.gitcd easyeda_mcpnpm installnpm run setup:localnpm 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:

json
{  "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:

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

Run in your terminal:

bash
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, 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, or add to .vscode/mcp.json (or Command Palette -> MCP: Open User Configuration) and open Copilot Chat (Agent mode):

json
{  "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:

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

Once connected, try real hardware engineering workflows:

text
Inspect the open schematic with easyeda_schematic_snapshot and list any unconnected pins.
text
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.
text
Read the active PCB design rules with easyeda_get_drc_rules and summarize track width, via size, and clearance limits.

More examples: Practical Workflows


Available Tools (32)

CategoryTools
Status & Contexteasyeda_doctor · easyeda_live_status · easyeda_get_context · easyeda_get_selection
Schematic Inspection & Searcheasyeda_schematic_snapshot · easyeda_list_schematic_components · easyeda_get_component_pins · easyeda_find_component · easyeda_find_net · easyeda_search_library
Circuit Tracing & Verificationeasyeda_trace_net · easyeda_trace_component · easyeda_find_unconnected_pins · easyeda_validate_schematic_area · easyeda_verify_connections
PCB Layout & DRC Ruleseasyeda_run_drc · easyeda_get_pcb_layers · easyeda_get_routing_status · easyeda_list_pcb_components · easyeda_highlight_net · easyeda_get_drc_rules · easyeda_prepare_drc_edit · easyeda_get_drc_edit_result
Navigation & Exportseasyeda_navigate_component · easyeda_navigate_region · easyeda_zoom_board · easyeda_export_cpl · easyeda_export_bom · easyeda_export_netlist · easyeda_export_gerber · easyeda_export_pdf
Confirmed Actionseasyeda_confirmed_action (save, importChanges, autoroute, autolayout, editDrcRules)

Full parameter schemas and examples: Tools Reference · DRC Rule Editing


Documentation

GuideWhen to use
Quick StartShortest path from zero to a working bridge
AI Client SetupDetailed setup for Claude Code, Codex, Claude Desktop, Cursor, VS Code, Antigravity & others
Practical WorkflowsCopy-pasteable prompts for schematic review, circuit assertions, DRC, and exports
Upgrading & CompatibilityServer/Extension version matrix and 3-step upgrade checklist
TroubleshootingCommon fixes and bridge error code reference
Architecture & Safety ModelHow the local WebSocket bridge and confirmation gates work
Changelog & ReleasesVersion history and prebuilt .eext / .mcpb downloads
Development & Local Testing
bash
npm run setup:local          # Build MCP server, extension bundle, .eext, and .mcpb packagesnpm run setup:clients        # Point detected AI clients to this local checkout (--local)npm test                     # Run Vitest unit suitenpm run typecheck            # Typecheck MCP servernpm run typecheck:extension  # Typecheck EasyEDA Pro extensionnpm run test:smoke:drc       # End-to-end stdio + WebSocket DRC smoke testnpm run docs:build           # Build VitePress documentation site

Security, Disclaimer & License

  • Localhost & Live Session: Operates on the live project open in EasyEDA Pro over 127.0.0.1:8765 (no offline .epro parsing or commercial/order automation). Do not expose the WebSocket port to untrusted networks — see SECURITY.md.
  • Non-Affiliation: Independent open-source project. Not affiliated with, endorsed by, or sponsored by EasyEDA, JLCPCB, or Shenzhen Jia Chuang Ban Technology Co., Ltd. EasyEDA and EasyEDA Pro are trademarks of their respective owners.
  • Sponsorship & Support: If you find this project useful, consider supporting its development via GitHub Sponsors.
  • Contact & License: [email protected] · Released under the MIT License.

Source: README.md at commit bf8a1e7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts