Easyeda Pro Mcp

io.github.VLab-Software由 GitHub 账号 VLab-Software 发布v1.0.2更新于 Nov 3, 2026

MCP server and EasyEDA Pro extension bridge for live project assistance.

已验证STDIO仅桌面文件与存储开发者工具

概览

AI 生成的概览

把 AI 助手连接到本机已打开的 EasyEDA Pro 工程,用于原理图与 PCB 的检查、验证、DRC 规则管理和导出。

可以做什么
  • 检查桥接健康状态、实时状态、当前上下文与选中对象
  • 检查与搜索原理图:快照、元件、引脚、网络和元件库
  • 追踪网络与元件、查找未连接引脚并执行电路断言验证
  • 审查 PCB 布局:运行 DRC、列出层与元件、查看布线状态、高亮网络、读取并准备 DRC 规则修改
  • 导航到元件或区域、缩放板面,并导出 CPL、BOM、网表、Gerber 和 PDF
  • 执行经确认的操作,如保存、导入变更、自动布线、自动布局和修改 DRC 规则
适用场景
适合在无需截图或手动导出的情况下,让助手审查已打开的 EasyEDA Pro 原理图或 PCB:追踪网络、检查上拉下拉、去耦或 USB-C CC 通路、读取设计规则,或生成生产文件。
运行要求
以 stdio 在本机运行,需要 Node.js 20 或更高版本、EasyEDA Pro 2.3.0 或更高版本并安装桥接扩展且允许外部交互,以及兼容 MCP 的客户端。可选环境变量 EASYEDA_MCP_WS_HOST 与 EASYEDA_MCP_WS_PORT 默认分别为 127.0.0.1 和 8765。
安装前请注意
检查操作是只读的,但经确认的操作可保存、导入变更、自动布线、自动布局和修改 DRC 规则,会改动当前打开的工程,需人工明确确认。setup 命令会改写检测到的 AI 客户端配置文件,导出操作会写出 Gerber、BOM、PDF 等文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Easyeda Pro Mcp,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[EasyEDA Pro MCP]

EasyEDA Pro MCP

Connect Claude, Codex, Cursor, VS Code, Antigravity, and other Model Context Protocol (MCP) clients to the live EasyEDA Pro project already open on your machine.

Independent open-source MCP bridge for live schematic and PCB workflows in EasyEDA Pro.

[CI] [npm] [Release] [License] [Node] [Platforms] [Sponsor]

[Install in Cursor] [Install in VS Code] [Claude Desktop .mcpb] [EasyEDA Extension .eext]

Quick Start · AI Client Setup · Tools · Troubleshooting · Releases

[Demo showing EasyEDA Pro with the MCP Bridge workflow in action]

Key Features

  • Live schematic & PCB introspection — Give AI agents structured access to your open EasyEDA Pro project without screenshots or manual exports.
  • Circuit tracing & verification — Trace nets and component pins, find unconnected pins, and run programmatic assertions (pull-ups/downs, decoupling capacitors, USB-C 5.1k CC paths).
  • Native PCB DRC rule management — Read active design rules, saved profiles, and net/region tables, preview changes safely, and apply confirmed rule updates with readback verification.
  • Editor navigation & fabrication exports — Focus components or regions directly in EasyEDA Pro and export BOM, Netlist, Gerber, and PDF files.
  • Local & read-first by default — Runs locally over stdio and ws://127.0.0.1:8765. Inspection is read-only; mutating actions require explicit human confirmation.

Requirements

  • Node.js 20 or newer
  • EasyEDA Pro 2.3.0 or newer
  • An MCP-compatible AI client (Claude Code, Codex, Claude Desktop, Cursor, VS Code, Antigravity, Windsurf, etc.)

Getting Started

EasyEDA Pro MCP has two local parts: the EasyEDA Pro Extension (.eext) inside the editor and the MCP Server (@vlabsoftware/easyeda-pro-mcp) launched by your AI client.

1. Automatic Setup (Fastest — No Git Clone)

Run one command in your terminal:

bash
npx -y @vlabsoftware/easyeda-pro-mcp setup

This automatically detects and configures installed AI clients (Claude Desktop, Cursor, VS Code, Antigravity, Windsurf, Claude Code, Codex) with platform-safe commands and exports easyeda_mcp_bridge.eext to your ~/Downloads folder (or current directory).

Building from source instead?
bash
git clone https://github.com/VLab-Software/easyeda_mcp.gitcd easyeda_mcpnpm installnpm run setup:localnpm run setup:clients   # Optional: points detected AI clients to this local build

This builds dist/index.js, build/dist/easyeda_mcp_bridge.eext, and build/dist/easyeda-pro-mcp.mcpb.

2. Install the EasyEDA Pro Extension

  1. In EasyEDA Pro, open Extensions Manager and import the exported easyeda_mcp_bridge.eext (or download easyeda_mcp_bridge.eext from Releases).
  2. Enable Allow interactive with external for EasyEDA MCP Bridge.
  3. Open your schematic or PCB project (if needed, click MCP Bridge -> Reconnect in the top toolbar).

3. Or Add the MCP Server Manually / 1-Click

If you skipped npx -y @vlabsoftware/easyeda-pro-mcp setup, use a 1-click badge above or add the standard npx config below:

json
{  "mcpServers": {    "easyeda-pro": {      "command": "npx",      "args": ["-y", "@vlabsoftware/easyeda-pro-mcp"]    }  }}

Windows JSON note: In GUI clients on Windows, use "command": "cmd", "args": ["/c", "npx", "-y", "@vlabsoftware/easyeda-pro-mcp"] so npx.cmd spawns cleanly.

Claude Code

Run in your terminal:

bash
claude mcp add --scope user easyeda-pro -- npx -y @vlabsoftware/easyeda-pro-mcp
Codex

Run in your terminal:

bash
codex mcp add easyeda-pro -- npx -y @vlabsoftware/easyeda-pro-mcp
Claude Desktop
  • 1-Click Bundle: Download easyeda-pro-mcp.mcpb and double-click it to install in Claude Desktop.
  • Manual JSON: Or add the standard config above to claude_desktop_config.json, then fully quit and reopen Claude Desktop:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json (use "command": "cmd", "args": ["/c", "npx", "-y", "@vlabsoftware/easyeda-pro-mcp"])
Cursor

Click Install in Cursor, or add the standard config above to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project) and refresh servers in Cursor Settings -> MCP.

VS Code (GitHub Copilot)

Click Install in VS Code, or add to .vscode/mcp.json (or Command Palette -> MCP: Open User Configuration) and open Copilot Chat (Agent mode):

json
{  "servers": {    "easyeda-pro": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@vlabsoftware/easyeda-pro-mcp"]    }  }}
Antigravity & Windsurf
  • Antigravity: Run npx -y @vlabsoftware/easyeda-pro-mcp setup --client antigravity (or add the standard config to ~/.gemini/config/mcp_config.json), then click Refresh in Additional Options (...) -> MCP Servers.
  • Windsurf: Run npx -y @vlabsoftware/easyeda-pro-mcp setup --client windsurf (or add the standard config to ~/.codeium/windsurf/mcp_config.json), then refresh MCP servers in Cascade settings.

Your First Prompts

Verify that the bridge is connected and sees your open document:

text
Run easyeda_doctor and check whether the EasyEDA Pro bridge is healthy.

Once connected, try real hardware engineering workflows:

text
Inspect the open schematic with easyeda_schematic_snapshot and list any unconnected pins.
text
Verify USB1 with easyeda_verify_connections: check that CC1 and CC2 each have a 5.1k resistor to GND and VBUS is decoupled to GND.
text
Read the active PCB design rules with easyeda_get_drc_rules and summarize track width, via size, and clearance limits.

More examples: Practical Workflows


Available Tools (32)

CategoryTools
Status & Contexteasyeda_doctor · easyeda_live_status · easyeda_get_context · easyeda_get_selection
Schematic Inspection & Searcheasyeda_schematic_snapshot · easyeda_list_schematic_components · easyeda_get_component_pins · easyeda_find_component · easyeda_find_net · easyeda_search_library
Circuit Tracing & Verificationeasyeda_trace_net · easyeda_trace_component · easyeda_find_unconnected_pins · easyeda_validate_schematic_area · easyeda_verify_connections
PCB Layout & DRC Ruleseasyeda_run_drc · easyeda_get_pcb_layers · easyeda_get_routing_status · easyeda_list_pcb_components · easyeda_highlight_net · easyeda_get_drc_rules · easyeda_prepare_drc_edit · easyeda_get_drc_edit_result
Navigation & Exportseasyeda_navigate_component · easyeda_navigate_region · easyeda_zoom_board · easyeda_export_cpl · easyeda_export_bom · easyeda_export_netlist · easyeda_export_gerber · easyeda_export_pdf
Confirmed Actionseasyeda_confirmed_action (save, importChanges, autoroute, autolayout, editDrcRules)

Full parameter schemas and examples: Tools Reference · DRC Rule Editing


Documentation

GuideWhen to use
Quick StartShortest path from zero to a working bridge
AI Client SetupDetailed setup for Claude Code, Codex, Claude Desktop, Cursor, VS Code, Antigravity & others
Practical WorkflowsCopy-pasteable prompts for schematic review, circuit assertions, DRC, and exports
Upgrading & CompatibilityServer/Extension version matrix and 3-step upgrade checklist
TroubleshootingCommon fixes and bridge error code reference
Architecture & Safety ModelHow the local WebSocket bridge and confirmation gates work
Changelog & ReleasesVersion history and prebuilt .eext / .mcpb downloads
Development & Local Testing
bash
npm run setup:local          # Build MCP server, extension bundle, .eext, and .mcpb packagesnpm run setup:clients        # Point detected AI clients to this local checkout (--local)npm test                     # Run Vitest unit suitenpm run typecheck            # Typecheck MCP servernpm run typecheck:extension  # Typecheck EasyEDA Pro extensionnpm run test:smoke:drc       # End-to-end stdio + WebSocket DRC smoke testnpm run docs:build           # Build VitePress documentation site

Security, Disclaimer & License

  • Localhost & Live Session: Operates on the live project open in EasyEDA Pro over 127.0.0.1:8765 (no offline .epro parsing or commercial/order automation). Do not expose the WebSocket port to untrusted networks — see SECURITY.md.
  • Non-Affiliation: Independent open-source project. Not affiliated with, endorsed by, or sponsored by EasyEDA, JLCPCB, or Shenzhen Jia Chuang Ban Technology Co., Ltd. EasyEDA and EasyEDA Pro are trademarks of their respective owners.
  • Sponsorship & Support: If you find this project useful, consider supporting its development via GitHub Sponsors.
  • Contact & License: [email protected] · Released under the MIT License.

来源:README.md,提交 bf8a1e7

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分