EasyEDA MCP
Provides tools for interacting with EasyEDA / JLCEDA Pro, including project and document inspection, schematic/PCB component and netlist reading, DRC checking, domain API calls, PCB auto-layout and auto-routing, and Gerber/BOM/pick-and-place manufacturing file export.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EasyEDA MCP Run easyeda_doctor, then inspect my current EasyEDA project read-only."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EasyEDA MCP
当前主交付为 嘉立创 EDA 内部 .eext 扩展,源码和安装包位于 extension/。14 个领域接口通过客户端内置 MCP 与 external.easyedaMcp.* 使用,带 EDA 内部面板,默认只读。
已按用户授权安装 .eext 版本 0.1.0-dev.20261019.3,完成 14 个接口发现及原理图/PCB、引脚、网表只读检查;详见 本机验证。构建:在 extension 中执行 npm ci --ignore-scripts、npm test、npm run build。
已完成独立 LED 测试的原理图设计、PCB 同步、自动布局布线、严格 DRC、保存重开和制造文件导出;详见 全流程实测。输出保留在本地 artifacts/led-e2e-20261019,该目录已忽略,不随源码仓库提交。
以下保留前序 stdio 试作的说明,其工具发现结果不代表内部 .eext 的安装或验收。
EasyEDA MCP
在嘉立创 EDA / EasyEDA 专业版内置 MCP之上提供 11 个领域工具,版本 0.1.0-dev.20261019.1。原生客户端继续负责电路编辑、布局布线与制造文件生成。本包提供工程识别、参数适配、分页、错误判断与实际文件校验。
本地开发候选,未发布/安装到全局。默认只读;已有官方原生服务为 http://127.0.0.1:31637/mcp。不需要 Run API Gateway,也不启动第二个编辑器或桥接服务。
启动与配置
仅依赖 Python 3.10+ 标准库,无需 pip install:
python3 -B scripts/serve.py这是 MCP stdio 服务,会等待宿主输入 JSON-RPC;stdout 不能用于普通日志。可从任何 cwd 用 serve.py 的绝对路径启动。宿主配置样例见 examples/codex-mcp.toml 和 examples/mcp.json,修改为实际绝对路径后再加载。本次没有执行全局安装或改写全局配置。
首次任务:“只读检查当前工程,先执行 easyeda_doctor,再 easyeda_inspect_project”。多会话传入实际 session。工程为空返回 no_project,工具不会打开最近工程。
Related MCP server: a2n-easyeda-mcp
工具
工具 | 能力 |
| 连接、版本、桥接与结果通道 |
| 会话与实际 sessionId |
| 工程、活动文档、板子、原理图页、PCB |
| 当前客户端的 API 签名 |
| 器件 ID/位号/坐标分页 |
| 原理图网表文本分页 |
| 当前图页的严格 DRC 布尔结果 |
| 经实时 mount/方法校验的领域 API 调用,需写入模式 |
| 官方 PCB 自动布局,需写入模式 |
| 官方 PCB 自动布线,保留失败网络,需写入模式 |
| Gerber/BOM/贴片坐标,需输出根目录 |
写入、布线和导出
用户授权修改后,宿主可用 --allow-write 启动。easyeda_call_api 提供 DMT/SCH/PCB/LIB 的通用 JSON 参数入口,不能注入 JavaScript 或调用 SYS 文件/网络接口。先查 API 签名、枚举与单位;修改后的图元和复杂返回需要专门回读,不能把 returned 当成验证成功。通用工具不支持把跨次调用的原语对象当作参数。
每次操作要求明确 document_uuid,先匹配当前文档和类型,再在同次 invoke 内核对焦点。用户在调用执行期间应保持目标图页;这不构成编辑器级事务锁。不会自动保存、删除既有布线或下单付款。自动布局/布线耗时较长,需宿主允许相应超时;超时后先读结果,不自动重放。
文件导出单独配置 --output-root /授权输出目录,不要求开启工程修改模式。工具仅写入此根目录中的新文件,已有文件不覆盖。Gerber 使用当前客户端的一键默认层/对象,BOM 和贴片坐标使用 CSV,贴片坐标为 mm。实际字节数/SHA256 与 Gerber ZIP CRC 会检查;板框、铜层、钻孔、电气与坐标正确性仍须回读和预览。单文件上限 20MiB,失败时报告已生成文件。
验证
python3 -B scripts/validate_package.py
python3 -B -m unittest discover -s tests -v
python3 -B scripts/smoke_readonly.py离线测试覆盖只读模式、文档 UUID/焦点变化、错误 DRC 结果、失败网络保留、输出目录逃逸、禁止覆盖、实际字节与 stdio 协议。smoke_readonly.py 启动真实 MCP 子进程,调用 doctor、会话、工程和 API 帮助,并验证写入模式关闭。它不导出或修改工程。脚本使用 POSIX pipe/select,已在本机 macOS 执行;服务本身没有此平台依赖。
最近实测服务为 JLCEDA Pro 4.1.71.7a7261be,doctor connected=true/versionMatch=true/resultChannel=true;工程仍返回 null,因此工程内容、DRC、自动布局/布线和制造导出未做真实板卡验收。该早期只读回执仅保留在本地,不随源码提交;当前 .eext 的完整验收见前文全流程实测。协议测试通过不代表模型已经在宿主内完成任务。
本地传输实现限定于已实测官方 JSON 响应,不是全功能 MCP SDK;不提供 SSE 消息流、跨请求后台任务或取消/恢复。长调用返回前不能处理其他工具请求。后续需要这些能力时优先使用官方 SDK,不扩展成另一套 Agent Runtime。
协议依据:MCP stdio、MCP tools。来源与设计见 docs/design.md、docs/transport-source.json、NOTICE。
Codex app-server 在临时 -c 配置下已发现全部 11 个工具,toolsError=null;该机器回执仅保留在本地,不随源码提交。这是宿主工具发现验证,未创建新聊天或运行模型任务。
本地 ZIP:python3 -B scripts/build_package.py,产物位于 dist,包含独立运行所需代码与文档。
源码仓库:full-aigc-plugins/easyeda-mcp。Git 仅保留源码、锁文件、自动化测试、CI 与说明文档,不提交 node_modules、构建输出或临时测试工程;当前尚未创建正式 Release。
Available Tools
11 toolseasyeda_auto_layoutADestructive
调用官方 PCB 自动布局。需 --allow-write;保留原始结果,另行回读/DRC;不自动保存。
Inputs: document_uuid (required), session. Returns: ok
easyeda_auto_routeADestructive
调用官方 PCB 自动布线;可指定 RoutingNets,保留 failedNets。需 --allow-write;不自动保存。
Inputs: document_uuid (required), nets, session. Returns: ok
easyeda_call_apiADestructive
高级写入入口:解析实时类 mount/方法,传递 JSON 参数调用 DMT/SCH/PCB/LIB API。必须以 --allow-write 启动且用户已授权。无任意 JavaScript、无系统文件/网络调用。超时后先回读,不重试。
Inputs: args (required), class_name (required), method_name (required), document_uuid (required), +1 more. Returns: ok
easyeda_check_drcBRead-onlyIdempotent
对指定活动原理图/PCB 执行严格 DRC 布尔检查,无弹窗;passed=false 保留失败。
Inputs: document_uuid (required), session. Returns: ok
easyeda_doctorARead-onlyIdempotent
检查官方原生 MCP 的版本、桥接与结果通道;不启动客户端、不打开工程。
Inputs: no named parameters. Returns: ok
easyeda_export_manufacturingADestructive
导出 Gerber ZIP、BOM CSV、贴片坐标 CSV 到 --output-root 内新文件。不修改/保存工程,不下单;核对字节、SHA256 和 ZIP CRC,制造正确性仍需预览。
Inputs: formats (required), destination (required), document_uuid (required), prefix, +1 more. Returns: ok
easyeda_get_apiARead-onlyIdempotent
查询目标客户端实时 API 文档;不会执行返回文档中的示例代码。
Inputs: class_name (required), method_name. Returns: ok
easyeda_inspect_projectARead-onlyIdempotent
只读当前工程、活动文档、板子、原理图页和 PCB;空工程明确返回 no_project。
Inputs: session. Returns: ok
easyeda_list_componentsARead-onlyIdempotent
分页读取活动原理图/PCB 的器件 ID、位号和坐标;原理图也可能包含旗标/端口。
Inputs: kind (required), document_uuid (required), limit, offset, +1 more. Returns: ok
easyeda_list_sessionsARead-onlyIdempotent
列出官方原生 MCP 的编辑器会话;返回实际 sessionId。
Inputs: no named parameters. Returns: ok
easyeda_read_netlistBRead-onlyIdempotent
只读原理图网表文件文本并分页返回;使用现行 ManufactureData API,不在磁盘写文件。
Inputs: document_uuid (required), limit, offset, session. Returns: ok
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools target clearly distinct operations: list_components (read parts), read_netlist (file text), check_drc (validation), auto_layout/auto_route (PCB automation), export_manufacturing (output), and diagnostic tools (doctor, list_sessions, inspect_project). The main soft spot is easyeda_call_api, a generic write escape hatch that conceptually overlaps with auto_layout/auto_route/export since those could technically be invoked through it, though its description frames it as a distinct advanced path.
Every tool uses the same easyeda_ prefix followed by a consistent snake_case verb_noun pattern (list_components, inspect_project, check_drc, auto_route, export_manufacturing). No mixing of camelCase or alternative verb styles.
11 tools is well-scoped for an EDA bridge: read/introspect, validate, automate, export, plus a low-level API escape hatch. Each tool covers a concrete, non-redundant capability.
The surface covers the full lifecycle reasonably: project/session introspection, component and netlist reads, DRC validation, PCB auto-layout/auto-route, manufacturing export, and an arbitrary-write path via call_api. Explicit higher-level schematic edit or project save tools are absent, but call_api provides an escape hatch, so gaps are minor.
Maintenance
Related MCP Connectors
Design, route, check, review and export manufacturable PCBs from plain language; KiCad import.
Design and revise PCBs from plain language, track jobs, and retrieve design artifacts.
Your electronics workspace. Explore public PCB projects and inspect schematics, layouts, BOMs and saved versions with your AI assistant.
EasyGerber brings AI printed circuit board (PCB) design, layout, and routing to MCP-compatible assistants. Describe a circuit or start from firmware pin assignments, search published electronic components, and build schematics using catalog parts with their footprints and available 3D models. Create and revise boards, generate layouts with automatic component placement and routing, inspect previews, and check saved layouts for blocking design issues. Export manufacturing ZIPs containing Gerber and drill files, a bill of materials, and component placement data, or download an editable EasyGerber (.egb) file. Start without signing up. Your agent creates a private guest session for one board, including catalog access, edits, layout, checks, previews, and exports. Sign in through OAuth to work with saved account boards, access permitted organization boards, or save the guest design to your account. Guest support depends on your MCP client and installed integration.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with 嘉立创 EDA for PCB design tasks including project management, component libraries, rule checking, and manufacturing constraints.13 npm-
- AlicenseBqualityCmaintenanceEnables MCP clients to control EasyEDA Pro for schematic and PCB design through natural language, bridging the EasyEDA API without external AI or API keys.49MIT
- FlicenseNot gradedqualityFmaintenanceEnables AI assistants to interact with JLCEDA EDA for schematic/PCB design operations like component placement, wiring, and circuit analysis through natural language.-
- AlicenseNot gradedqualityAmaintenanceEnables 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.216MIT