Easyeda Mcp Pro
About
MCP server for EasyEDA Pro: PCB inspection, BOM sourcing, manufacturing export, and AI-assisted hardware review.
Details
- License
- MIT
Explore
| Area | What you can do |
| --------------- | --------------------------------------------------------------------- |
| Schematic | List nets/components, search and place devices, edit wires/primitives |
| BOM | Generate, validate, export, and source bill of materials |
| DRC/ERC | Run design rule and electrical rule checks |
| Board | Inspect layers, stackup, dimensions, features |
| Export | Export Gerbers, pick-and-place, PDF, netlist |
| Diagnostics | Health check, bridge status, API inventory, capabilities, self-test |
---
- Rate limiting: Per-IP sliding window (configurable via HTTP_RATE_LIMIT_MAX), returns 429 Too Many Requests with retry-after header
- Security headers: X-Content-Type-Options: nosniff, X-Frame-Options: DENY, X-XSS-Protection: 0, Referrer-Policy: strict-origin-when-cross-origin
- Health endpoints: /healthz (liveness) and /readyz (readiness) return JSON status
See .env.example for the complete list of configuration variables.
---
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Easyeda Mcp ProCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The fastest way to install and configure easyeda-mcp-pro for your favorite AI assistant or IDE:
1. Auto-configure your MCP client:
npx easyeda-mcp-pro setup all
_This detects and configures Claude Desktop, Cursor, VS Code, Windsurf, Cline, Gemini, Zed, etc. to run the MCP server automatically._
_(Or run for a specific client, e.g., npx easyeda-mcp-pro setup claude)_
2. Locate and install the EasyEDA Pro bridge extension:
npx easyeda-mcp-pro extension --open
_This opens the folder containing the extension package easyeda-bridge-extension.eext. Import it via EasyEDA Pro → Settings → Extensions → Extension Manager._
3. Connect the bridge:
In EasyEDA Pro, click MCP Bridge → Connect in the menu bar.
For advanced configurations, manual instructions, and specific clients, see Installation & Client Configuration.
---
You can configure easyeda-mcp-pro automatically or manually.
The CLI setup automates editing the configuration files for your client:
npx easyeda-mcp-pro setup all
npx easyeda-mcp-pro setup <client>
To bridge the MCP server with EasyEDA Pro:
If you prefer to configure your clients manually, add the following configuration to the respective settings files:
<details>
<summary>🟣 Claude Desktop</summary>
Config Path:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "core"
}
}
}
}
</details>
<details>
<summary>🔵 Cursor IDE</summary>
Config Path: Project-specific .cursor/mcp.json or global ~/.cursor/mcp.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
<details>
<summary>🟢 VS Code (GitHub Copilot)</summary>
Config Path: %APPDATA%\Code\User\mcp.json (Windows), ~/Library/Application Support/Code/User/mcp.json (macOS), or ~/.config/Code/User/mcp.json (Linux)
{
"servers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
<details>
<summary>🏄 Windsurf (Codeium)</summary>
Config Path: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
<details>
<summary>🤖 Cline</summary>
Config Path: Cline VS Code extension global storage (cline_mcp_settings.json)
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
},
"disabled": false,
"autoApprove": []
}
}
}
</details>
<details>
<summary>✨ Gemini CLI / Antigravity</summary>
Config Path: ~/.gemini/settings.json or ~/.gemini/config/mcp_config.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
<details>
<summary>⚡ Zed Editor</summary>
Config Path: ~/.config/zed/settings.json
{
"context_servers": {
"easyeda-mcp-pro": {
"command": {
"path": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"]
},
"settings": {}
}
}
}
</details>
<details>
<summary>🔄 Continue.dev</summary>
Config Path: ~/.continue/config.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
<details>
<summary>👑 Amazon Q Developer</summary>
Config Path: ~/.aws/amazonq/mcp.json
{
"mcpServers": {
"easyeda-mcp-pro": {
"command": "npx",
"args": ["-y", "easyeda-mcp-pro@latest"],
"env": {
"TOOL_PROFILE": "pro"
}
}
}
}
</details>
---
If you are developing or running a modified local build:
git clone https://github.com/oaslananka/easyeda-mcp-pro.git
cd easyeda-mcp-pro
cp .env.example .env
pnpm install
node dist/index.js --setup-local
``
Beyond local stdio/HTTP, the server supports a hosted remote runtime (gateway, session router, and approval-scoped relay under src/remote/`) for managed connector deployments such as Claude Web or ChatGPT app integrations, plus a self-hosted remote mode for user-managed endpoints. See Remote MCP Modes for the full mode matrix and network/security boundaries of each.
core
48 tools
pro
63 tools
full
73 tools
dev
77 tools
The server currently registers up to 77 profile-gated tools. Tools are filtered by the active TOOL_PROFILE:
- core: 48 tools
- pro: 63 tools
- full: 73 tools
- dev: 77 tools
core exposes the standard workflow tools, pro adds manufacturing exports, full adds controlled documented EasyEDA API calls, and dev adds runtime probes for debugging.
Capability scopes add a second authorization layer when TOOL_SCOPES is set. Leave it empty for the default local all-capabilities mode, or restrict it with comma/space separated scopes such as diagnostics:read, schematic:read, schematic:write, bom:read, bom:source, checks:read, pcb:read, pcb:write, export:write, api:read, api:write, and bridge:execute.
Raw JavaScript execution is intentionally not part of the default dev tool set. easyeda_execute is registered only when both BRIDGE_RAW_EXEC_ENABLED=true and MCP_RAW_EXEC_EXPERIMENTAL=true are set; when TOOL_SCOPES is set it also requires bridge:execute.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"easyeda mcp pro": {
"easyeda-mcp-pro": {
"command": "npx",
"args": [
"easyeda-mcp-pro",
"setup",
"all"
]
}
}
}
}McpServers
{
"easyeda-mcp-pro": {
"command": "npx",
"args": [
"easyeda-mcp-pro",
"setup",
"all"
]
}
}<p>
Production-grade MCP server for EasyEDA Pro: safe PCB design inspection, BOM sourcing, manufacturing export, and AI-assisted hardware review.
</p>
<p>
<a href="https://www.npmjs.com/package/easyeda-mcp-pro">
</a>
<a href="https://www.npmjs.com/package/easyeda-mcp-pro">
</a>
<a href="https://www.npmjs.com/package/easyeda-mcp-pro">
</a>
<a href="LICENSE">
</a>
<a href="https://pnpm.io/">
</a>
</p>
<p>
<a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/ci.yml">
</a>
<a href="https://github.com/oaslananka/easyeda-mcp-pro/actions/workflows/deploy-docs.yml">
</a>
<a href="https://github.com/oaslananka/easyeda-mcp-pro/security/policy">
</a>
<a href="https://scorecard.dev/viewer/?uri=github.com/oaslananka/easyeda-mcp-pro">
</a>
<a href="https://www.bestpractices.dev/projects/13406">
</a>
</p>
<p>
<a href="https://deepwiki.com/oaslananka/easyeda-mcp-pro">Ask DeepWiki</a> ·
<a href="docs/ROADMAP.md">Roadmap</a> ·
<a href="docs/OPENSSF_BEST_PRACTICES.md">OpenSSF evidence</a> ·
<a href="docs/SECURITY_ASSURANCE_CASE.md">Security assurance case</a>
</p>
<p>
<strong>Compliance docs:</strong>
<a href="THIRD_PARTY_NOTICES.md">Third-Party Notices</a>
·
<a href="docs/vendor-terms.md">Vendor Terms and Unsupported Workflows</a>
·
<a href="docs/REMOTE_MCP_MODES.md">Remote MCP Modes</a>
</p>
<p>
<a href="https://www.buymeacoffee.com/oaslananka">
</a>
<a href="https://github.com/oaslananka/easyeda-mcp-pro">
</a>
</p>
</div>
---
Trust and Supply Chain
easyeda-mcp-pro keeps its public OpenSSF Best Practices evidence in docs/OPENSSF_BEST_PRACTICES.md and its security assurance case in docs/SECURITY_ASSURANCE_CASE.md. The header badges link to workflow-backed signals only: CI, generated docs deployment, the project security policy, OpenSSF Best Practices self-certification, and the OpenSSF Scorecard. Release integrity evidence (npm provenance, signed-release status) is tracked in docs/RELEASE_VERIFICATION.md.
Current OpenSSF Best Practices status: Passing (100%) — see live badge and Silver evidence map for in-progress Silver criteria.
---
Quick Start
The fastest way to install and configure easyeda-mcp-pro for your favorite AI assistant or IDE:
1. Auto-configure your MCP client:
npx easyeda-mcp-pro setup all
_This detects and configures Claude Desktop, Cursor, VS Code, Windsurf, Cline, Gemini, Zed, etc. to run the MCP server automatically._
_(Or run for a specific client, e.g., npx easyeda-mcp-pro setup claude)_
2. Locate and install the EasyEDA Pro bridge extension:
npx easyeda-mcp-pro extension --open
_This opens the folder containing the extension package easyeda-bridge-extension.eext. Import it via EasyEDA Pro → Settings → Extensions → Extension Manager._
3. Connect the bridge:
In EasyEDA Pro, click MCP Bridge → Connect in the menu bar.
For advanced configurations, manual instructions, and specific clients, see Installation & Client Configuration.
---
Overview
easyeda-mcp-pro is a Model Context Protocol (MCP) server that bridges AI assistants with hardware design workflows in EasyEDA Pro. It exposes up to 60 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, BOM management, design rule checks, PCB board analysis, fabrication exports, diagnostics, and supplier integration.
The server connects to EasyEDA Pro via a WebSocket bridge extension, enabling real-time access to open project data. It integrates with JLCPCB, LCSC, Mouser, and DigiKey for BOM sourcing and pricing.
Key Capabilities
| Area | What you can do |
| --------------- | --------------------------------------------------------------------- |
| Schematic | List nets/components, search and place devices, edit wires/primitives |
| BOM | Generate, validate, export, and source bill of materials |
| DRC/ERC | Run design rule and electrical rule checks |
| Board | Inspect layers, stackup, dimensions, features |
| Export | Export Gerbers, pick-and-place, PDF, netlist |
| Diagnostics | Health check, bridge status, API inventory, capabilities, self-test |
---
Prerequisites
- Node.js >=24 <27 (required for the latest JavaScript features)
- pnpm >=11 (for local development; the npm package is self-contained)
- EasyEDA Pro with the bundled bridge extension installed and running
- For supplier integration: API credentials from JLCPCB, LCSC, Mouser, or DigiKey
---
Installation & Client Configuration
You can configure easyeda-mcp-pro automatically or manually.
1. Automatic Configuration (CLI)
The CLI setup automates editing the configuration files for your client:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
