easyeda-agent-mcp

An MCP server that bridges Claude Code (and other MCP clients) to EasyEDA Pro for PCB design, plus a TypeScript library for editing schematics programmatically when the tool-call API is too slow.

It's two pieces talking over WebSocket: the MCP server runs as a stdio process spawned by the client and exposes EasyEDA operations as tools, while a companion browser/desktop extension runs inside EasyEDA Pro itself, connects to the server's WebSocket, and dispatches the calls into EasyEDA's internal eda.* namespace. The server scans a port range to find active extensions and supports multiple EasyEDA Pro instances running at once.

• ~80 tools covering schematic primitives, PCB primitives, component libraries, design rule checking, manufacture-file exports, and document I/O
• Bulk-edit path — document_get_source/document_set_source and project_export_file/project_import_file read and write whole documents (or entire .epro projects as ZIPs) in one round-trip, for workflows where the per-operation API is too slow
• A schematic-editing library (src/lib/) that manipulates the raw NDJSON document format directly — pull the source, edit it locally as fast as you want, push it back once
• A documented .esch file-format reference: coordinate system, element line formats, netport recipe, and the gotchas found along the way (junction wires required at component-to-component connections, every component needing a non-empty Unique ID, some components resolving their symbol via project.json rather than a Symbol attribute)

The MCP server has been in active daily use for months. The editing library is newer, validated so far on round-trip integrity, auto-designator allocation, and adding a batch of series resistors + netports to an FPGA's JTAG/config pins with the connectivity confirmed through the netlist engine. It's not wired into MCP tools yet by design — the API is still being shaped through throwaway scripts before it gets exposed. PCB editing and component-flip handling aren't in the library yet; those still go through the server's existing per-operation tools.