Skip to main content
Glama
EasyEDA Standard MCP Server

EasyEDA Standard MCP Server

EasyEDA Standard MCP Server & Browser Bridge

A Model Context Protocol (MCP) tool suite that allows an LLM to dynamically read, query, search, and manipulate an active EasyEDA Standard schematic or PCB canvas in real time.

Architecture

[ LLM Client (Cursor/Claude) ]
              |
              | MCP Protocol (stdio)
              v
[ Python MCP Server ]  <---->  [ LCSC Public API ]
              |
              | WebSocket JSON (ws://localhost:8765)
              v
[ EasyEDA Extension Bridge (Browser) ]
              |
              | Native api()
              v
[ EasyEDA Standard Tab ]

Related MCP server: 果子狸MCP服务

1. Install Python Dependencies

# Create and activate virtual environment (if not already done)
python -m venv mcpservervenv
source mcpservervenv/bin/activate   # Linux/macOS
mcpservervenv\Scripts\activate      # Windows

# Install dependencies
pip install -r requirements.txt

2. Install the EasyEDA Extension

  1. Open EasyEDA Standard in your browser.

  2. Go to Settings > Advanced > Extensions Setting.

  3. Click Load Extension.

  4. Click Select Files and select all files from the easyeda-extension/ folder.

  5. Enter a name (e.g., "MCP Bridge") and click Load.

  6. Close and reopen the EasyEDA editor.

  7. Verify that the MCP Bridge button appears on the toolbar and shows Connected (green) when the Python server is running.

3. Configure the MCP Client

Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "easyeda": {
      "command": "C:\\Users\\casmm\\schmemcp\\mcpservervenv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\casmm\\schmemcp\\bridge_server.py"
      ]
    }
  }
}

Cursor

Add the following to your Cursor MCP settings (.cursor/mcp.json or via the UI):

{
  "mcpServers": {
    "easyeda": {
      "command": "C:\\Users\\casmm\\schmemcp\\mcpservervenv\\Scripts\\python.exe",
      "args": [
        "C:\\Users\\casmm\\schmemcp\\bridge_server.py"
      ]
    }
  }
}

Note: Adjust the paths to match your actual installation location.

4. Available MCP Tools

Tool

Description

get_canvas_source(type)

Retrieve the full active EasyEDA document (json, compress, or svg)

search_lcsc_component(query)

Search the LCSC/EasyEDA parts database by keyword or C-number

search_datasheet(lcsc_id)

Fetch the datasheet (PDF link + metadata) for an LCSC part number, e.g. "C238060" — runs entirely in Python

place_component(title, x, y)

Place a schematic component on the canvas

eval_browser_js(code)

Execute JS in the EasyEDA context — the only way to draw REAL wires (cc.hooks.importShape with a c_etype="wire" polyline; see AGENT_KNOWLEDGE_BASE.md §4b)

update_net_name(gid, net_name)

Update the net assignment of a pad or track element

move_component(gid, x, y)

Move a component to an absolute canvas position

move_component_to(gids, x, y)

Move one or more shapes to an absolute canvas position

move_components(gids, dx, dy)

Move one or more components by a relative offset

delete_component(gids)

Delete one or more shapes/components by their gIds

run_batch(operations)

Execute a sequence of operations in order with a single round-trip (see AGENT_KNOWLEDGE_BASE.md §6)

5. Troubleshooting

  • Badge shows "Disconnected": Ensure bridge_server.py is running.

  • Badge shows "Reconnecting...": The WebSocket server is not reachable. Check that port 3579 is not blocked (not 8765 — this is the port actually used by bridge_server.py and easyeda-extension/main.js).

  • Tool returns browser error: Ensure the EasyEDA editor tab is fully loaded and active.

6. Verified API Notes (edit 2026-09)

Findings verified by probing the live EasyEDA Standard editor (6.5.51) from the browser extension:

  • place_component now works. It fetches the LCSC item from https://easyeda.com/api/products/{lcsc}/components?version=6.4.19.5, then calls api('createShape', {shapeType:'schlib', uuid, datastrid, from:'system', title, x, y}) and polls getSource until the new schlib entry appears (returns its gId). Previously it called the non-existent api('searchLccComponent', ...), which the api() guard silently dropped, so the MCP request timed out after 60 s.

  • Only a subset of EasyEDA api() methods are registered in the extension's registry: verified live = getSource, getShape, getSelectedIds, delete, rotate, createShape, doCommand. createShape is async for lib items (returns undefined, lands the shape a few seconds later).

  • Working LCSC placement flow (verified: placed C123302 as gge233):

    1. GET https://easyeda.com/api/products/{lcsc}/components?version=6.4.19.5 → result.uuid + result.datastrid (this endpoint returns only the schematic-symbol item; there is no separate footprint fetch needed for the schematic).

    2. In the extension context:

      api('createShape', {
        shapeType: 'schlib',
        uuid: <uuid>,
        datastrid: <datastrid>,
        from: 'system',
        title: '<lcsc>',
        x: <px>, y: <px>,     // 1 px = 10 mil
      });
  • createShape with from:'EasyEDALibs' + title returns false (synchronous) if the title is not resolvable; from:'system' + shortUrl/uuid is the path that works.

  • To confirm placement, read back with getSource({type:'json'}) and diff schlib keys. Canvas origin is top-left; existing title frames may sit at negative Y.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • 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
    • F
      license
      B
      quality
      C
      maintenance
      Connects Jia Li Chuang EDA / EasyEDA Pro schematics to MCP clients, enabling AI-driven schematic editing, reading, and analysis.
      19
      -
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP-capable AI agents to generate and reorganize schematics, resolve LCSC components, place and route PCBs with custom DRC constraints, inspect design data, and safely apply, repair, or restore changes in native EasyEDA Pro and JLCEDA documents.
      219
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to control EasyEDA Pro desktop via typed MCP actions for creating projects, searching and placing components, wiring, layout and routing, running DRC, and exporting Gerber/BOM files.
      1
      Apache 2.0