jlceda-ai-agent
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
嘉立创 EDA AI Agent
This is a local AI automation framework for 嘉立创 EDA Professional. The MCP layer holds no project state; only the Python Broker keeps WebSocket connections and pending requests in-process. When the service stops, the connections, requests, and temporary images all disappear.
Architecture
MCP Client / AI Agent
|
| Streamable HTTP: POST /mcp
v
Stateless MCP tools
|
| in-process call
v
In-memory asyncio Broker
|
| JSON over WebSocket: /ws
v
JLCEDA TypeScript Extension
|
v
JLCEDA Extension API (eda.*)Screenshots are not passed over WebSocket as Base64. The Extension uploads a Blob via POST /upload/image and returns a temporary /files/{id} URL to the MCP caller. Images expire after 5 minutes by default, and are deleted immediately when the service exits.
Related MCP server: jlceda-mcp
Directory
mcp_server/
main.py # 独立服务入口
application.py # HTTP、WebSocket、MCP ASGI 组合
mcp_api/ # 无状态 MCP 工具定义
broker/ # 唯一有状态组件(仅内存)
protocol/ # WebSocket JSON 协议
files/ # 临时图片存储
tests/
lc_extension/
src/main.ts
src/websocket/ # 注册、心跳、RPC 响应、重连
src/commands/ # schematic、PCB、DRC、capture
src/utils/
extension.json
build/dist/ # npm run build 生成 .eextStarting the Backend
The project already has its dependencies installed using mcp_server/.venv:
cd mcp_server
source .venv/bin/activate
python main.pyDefault addresses:
MCP:
http://127.0.0.1:8000/mcpExtension WebSocket:
ws://127.0.0.1:8000/wsHealth check:
http://127.0.0.1:8000/healthImage upload:
http://127.0.0.1:8000/upload/image
Auto-Configure MCP Client
After the backend is started, you can run the installation script to automatically scan the MCP Clients installed on this machine and write the jlceda-ai-agent service into the corresponding global configuration file:
cd mcp_server
python install.py --installThe script supports Claude Desktop/Code, Cursor, Windsurf, Codex, Cline, Roo Code, Kilo Code, VS Code, Gemini CLI, OpenCode, Kimi Code, Zed, and other common Clients. It only processes the Clients it detects, and does not overwrite other MCP services already in the configuration; files whose JSON or TOML cannot be parsed are skipped.
python install.py --list # 查看支持项及扫描结果
python install.py --install codex,cursor # 指定 Client
python install.py --url http://127.0.0.1:9000/mcp
python install.py --dry-run # 只预览
python install.py --uninstall # 从检测到的 Client 中移除After writing the configuration, the corresponding MCP Client must be fully restarted. The installation script only handles the Client configuration; the backend service still needs to be started separately as described in the next section.
Available environment variables:
名称 | 默认值 | 说明 |
|
| 监听地址 |
|
| 监听端口 |
|
| Extension RPC timeout in seconds |
|
| Seconds before a project is considered offline |
|
| Temporary image TTL in seconds |
|
| Per-image size limit |
| empty | Public base URL returned behind a reverse proxy |
Build and Install the Extension
cd lc_extension
npm install
npm run typecheck
npm run buildGenerated files:
lc_extension/build/dist/jlceda-ai-agent_v0.1.0.eextIn 嘉立创 EDA Professional V3, install it via “Advanced → Extension Manager → Import”. After installing, you must enable "Allow external interaction" for the extension; otherwise the official SYS_WebSocket and SYS_ClientUrl APIs will reject the WebSocket connection and image uploads.
The Extension uses the current project's UUID as project_id, and also provides the project name through list_projects. After switching projects, the next heartbeat will automatically re-register. Therefore the AI should first call list_projects and then place the returned project_id into each subsequent EDA tool call.
If the backend address changes, update it accordingly:
lc_extension/src/config.tsMCP Tools
Projects and libraries:
list_projects、project.get_infocomponent.search
Schematic reading and inspection:
schematic.get_info、schematic.get_netlist、schematic.run_drc
Schematic components and cleanup:
schematic.place_component、schematic.add_componentschematic.modify_component、schematic.delete_componentsschematic.delete_wires、schematic.modify_wire、schematic.clearschematic.set_pin_no_connect
Schematic nets and wiring:
schematic.create_net_flag、schematic.create_net_portschematic.create_net_label、schematic.connect_netschematic.create_wire、schematic.connectschematic.auto_layout、schematic.auto_route
PCB:
pcb.get_info、pcb.place_component、pcb.modify_component、pcb.delete_componentspcb.create_track、pcb.modify_track、pcb.create_board_outlinepcb.create_via、pcb.modify_via、pcb.delete_routing_primitivespcb.clear_routing、pcb.route_net、pcb.auto_route、pcb.auto_layoutpcb.run_drc
Screenshots:
capture.schematic、capture.pcb、capture.region
The recommended AI part-selection flow is: first call component.search and read each candidate's name, description, symbol, footprint, 3D model, extended attributes, and library_uuid/device_uuid; after the AI makes its selection, pass these two UUIDs to schematic.place_component for exact placement. Search results are returned page by page (20 by default, up to 100 per page); when has_more is true, the AI can request the next page, avoiding a large number of candidates flooding the model context. schematic.add_component remains the compatible shortcut for "search and place the first result".
For cross-sheet schematic connections, prefer schematic.connect_net. It places net flags, ports, or labels of the same net directly onto the target pins, so there are no accidental short circuits from crossing wires. When real wires are needed, use waypoints on schematic.connect or points on schematic.create_wire to explicitly specify an orthogonal path; by default, crossings with wires on other nets are checked and rejected with WIRE_CROSSING. This protection is skipped only when the caller explicitly passes allow_crossings=true.
schematic.clear removes the placed components, net flags, and wires on the current sheet, but keeps frame/title-block primitives that have no pins, no reference designators, and no nets. For targeted cleanup, use schematic.delete_components or schematic.delete_wires instead.
pcb.route_net invokes 嘉立创's single-net autorouter; pcb.auto_route supports net allowlists, exclusion lists, and speed/completion-rate strategies. Both the schematic and PCB DRC use the detailed result mode. Some 嘉立创 APIs are still marked as Beta; after upgrading the EDA, re-run the TypeScript type checks and do a regression on a real device.
Verification
cd mcp_server
.venv/bin/python -m pytest -q
cd ../lc_extension
npm audit --audit-level=moderate
npm run typecheck
npm run buildCurrent automated verification includes protocol validation, Broker RPC round trips, capability checks, HTTP image upload/read, and the official type check and .eext packaging for the Extension.
Design Boundaries
No Redis, SQLite, or any other database is used.
MCP tools hold no WebSocket, project, or EDA state.
The Broker only stores online connections, heartbeat times, and pending requests.
The Extension does not know about MCP; it only handles Broker JSON RPC.
No AI conversations or PCB/schematic data is stored.
Images exist only in the system temporary directory and are cleaned up by TTL.
嘉立创 official reference: Getting started with the Extension API、Invoking the Extension API、SYS_WebSocket。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
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 uses one private board reference to create and continue a board, including catalog access, edits, layout, checks, previews, and exports, without a separate guest setup step or token to manage. To keep the board in your account or work with permitted saved personal or organization boards, complete EasyGerber sign-in and OAuth consent, then resume the same task. Account permissions, plan limits, and generation billing apply; support depends on your MCP client and installed integration.
Design circuits, simulate and verify embedded firmware, and lay out PCBs with AI agents.
Design, route, check, review and export manufacturable PCBs from plain language; KiCad import.
Autonomous 0-DRC PCB Routing, RF/DFM Pre-Flight & KiCad MCP Server (calligraphyeda.com).
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI coding assistants to control JLCPCB EDA for PCB automation, exposing 39 tools for component manipulation, routing, copper pour, DRC, and more. Includes a built-in PCB agent for orchestrating multi-step tasks.59276MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with 嘉立创 EDA for PCB design tasks including project management, component libraries, rule checking, and manufacturing constraints.24 npm-
- FlicenseBqualityCmaintenanceConnects Jia Li Chuang EDA / EasyEDA Pro schematics to MCP clients, enabling AI-driven schematic editing, reading, and analysis.19-
- AlicenseCqualityDmaintenanceAn MCP server that enables AI programming assistants to directly control JLCPCB EDA for PCB design automation, offering 39 tools for component placement, routing, copper pour, DRC, and a PCB Agent for autonomous complex tasks.43MIT