Skip to main content
Glama
cheewee2000

easyeda-mcp

by cheewee2000
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

easyeda-mcp

MCP server that controls a running EasyEDA Pro instance from Claude Code (or any MCP client), via JLCEDA's easyeda-api-skill bridge and the run-api-gateway extension.

Version 0.2.0

How it works

MCP client ⇄ (stdio) ⇄ easyeda-mcp ⇄ (HTTP, port 49620-49629) ⇄ bridge server ⇄ (WebSocket) ⇄ EasyEDA Pro

The bridge server and the EasyEDA-side extension are JLCEDA's published artifacts — this server wraps them with fast discovery (cached port, parallel scan, single round trip per call) and high-level tools so common actions are one tool call instead of hand-written scripts.

Related MCP server: a2n-easyeda-mcp

Tools

Tool

What it does

easyeda_execute

Run arbitrary JS inside EasyEDA (async function(eda){...} body)

easyeda_health / easyeda_start_bridge / easyeda_stop_bridge

Bridge lifecycle (auto-starts on demand)

easyeda_list_windows / easyeda_select_window

Multi-window targeting

easyeda_drc_get_rules

Current DRC rule configuration + net/region/net-by-net rules (mm)

easyeda_drc_set_rules

Patch DRC rules via deep merge (see caveat below)

easyeda_drc_check

Run DRC, return the violation list

easyeda_drc_net_classes

Net classes & differential pairs: list/create/delete/add/remove

easyeda_get_state

One-call orientation: project, board, PCB, schematic, DRC config

easyeda_open_project

Open a project by (partial) name

easyeda_save

Save open PCB/schematic documents

easyeda_get_netlist

Schematic netlist (connectivity source of truth); flags empty-Unique-ID parts that can't sync

easyeda_survey_pcb

One-call component + per-net + per-layer geometry survey, normalized to mils

easyeda_sync_to_pcb

Safe importChanges: diff netlist vs PCB pad nets (dry-run default), then optionally apply & re-verify

The last three distill hard-won behavioral traps from real board work (mixed 1-mil/10-mil getters, the getNetlist "i is not iterable" trap when a PCB tab is active, and importChanges silently no-op'ing on Unique-ID mismatches) into tools that handle them for you.

Setup

  1. Install the easyeda-api-skill bridge and the run-api-gateway.eext extension in EasyEDA Pro (enable its External Interactions permission).

  2. Point this server at the bridge script if it's not at the default path: EASYEDA_BRIDGE_SCRIPT=/path/to/bridge-server.mjs

  3. Register with your MCP client, e.g. for Claude Code:

{
  "mcpServers": {
    "easyeda": { "command": "node", "args": ["/path/to/easyeda-mcp/index.mjs"] }
  }
}

Known limitation: global DRC rule writes

EasyEDA Pro v2.2.47.x has an engine bug: the BETA overwriteCurrentRuleConfiguration() API deadlocks and saveRuleConfiguration() is non-functional. easyeda_drc_set_rules therefore fast-fails global config writes (~5s) with guidance, while per-net, region, and net-by-net rule writes work fully. If a newer EasyEDA build fixes the API, the fast-fail can be removed.

Development

npm run smoke                        # spawns the server, checks tool registration + health
node --test test/deep-merge.test.mjs # unit tests

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • a2n-easyeda-mcp

    anwarminarso
    A
    license
    B
    quality
    C
    maintenance
    Enables MCP clients to control EasyEDA Pro for schematic and PCB design through natural language, bridging the EasyEDA API without external AI or API keys.
    49
    MIT

  • 果子狸MCP服务

    lyq11
    F
    license
    B
    quality
    B
    maintenance
    Connects Jia Li Chuang EDA / EasyEDA Pro schematics to MCP clients, enabling AI-driven schematic editing, reading, and analysis.
    19
    -