Easyeda MCP Pro

EasyEDA MCP Pro

Inspect, review, and safely automate EasyEDA Pro designs from MCP-compatible AI assistants.

Documentation · Getting Started · Tool Reference · Compatibility · Roadmap · DeepWiki

Trust and Supply Chain

easyeda-mcp-pro keeps historical 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 current workflow-backed signals only: CI, generated docs deployment, the project security policy, and the OpenSSF Scorecard. Release integrity evidence (npm provenance, signed-release status) is tracked in docs/RELEASE_VERIFICATION.md. Coverage, Test Analytics, and extension bundle monitoring are documented in docs/CODECOV_ANALYTICS.md.

Licensing note: current repository source is MIT-licensed. Commercial use is permitted under MIT; historical releases retain the license notices shipped with them.

More project references: OpenSSF evidence · Security assurance · Third-party notices · Vendor terms · Remote MCP modes

Support development: Buy me a coffee · Star on GitHub

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)_

1. 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._

1. Connect the bridge: In EasyEDA Pro, click MCP Bridge → Connect in the menu bar. On EasyEDA Web, Local also works with the server on the same PC. For a separate self-hosted gateway, use MCP Bridge → Connect Custom Remote... (Experimental) with its secure WSS Relay address and one-time EDA-XXXXXXXX pairing code; this is not the public HTTP /mcp URL. Details.

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 126 profile-gated MCP tools for schematic inspection and editing, controlled EasyEDA Pro API calls, Personal Device metadata, 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

Prerequisites

• Node.js: Node.js 24.x is required; repository automation is pinned to 24.22.1.
• pnpm: local development and automation require exactly 11.28.8.

Prepare the supported runtime before installing dependencies:

nvm install 24.22.1

nvm use 24.22.1 corepack enable corepack prepare pnpm@11.28.8 --activate node scripts/check-runtime.mjs --require-pnpm

• EasyEDA Pro with the bundled bridge extension installed and running
• For supplier integration: API credentials from JLCPCB, LCSC, Mouser, or DigiKey

Installation & Client Configuration

Stable v1 is published. If you are upgrading from a pre-v1 release, follow Migrating to v1.

You can configure easyeda-mcp-pro automatically or manually.

1. Automatic Configuration (CLI)

The CLI setup automates editing the configuration files for your client:

# Configure all detected clients automatically

npx easyeda-mcp-pro setup all

Or configure a specific client

npx easyeda-mcp-pro setup

Supported Client Keys:

• claude (Claude Desktop)
• cursor (Cursor IDE)
• vscode (VS Code Copilot)
• windsurf (Windsurf)
• cline (Cline)
• gemini (Gemini CLI / Antigravity)
• zed (Zed Editor)
• amazonq (Amazon Q Developer)
• continue (Continue.dev)

Options:

• --profile : Specify the tool profile. Options: core (default), pro, full, dev. Example: npx easyeda-mcp-pro setup cursor --profile full

2. Extension Installation

To bridge the MCP server with EasyEDA Pro:

# Open the directory containing the .eext extension package in your file manager

npx easyeda-mcp-pro extension --open

Or copy it to a specific directory

npx easyeda-mcp-pro extension --copy /path/to/destination

Installation steps in EasyEDA Pro:

1. Open EasyEDA Pro.
2. Go to Settings → Extensions → Extension Manager.
3. Click Import Extension and select the easyeda-bridge-extension.eext file.
4. Ensure Allow External Interaction is enabled for the extension.
5. Fully quit and reopen EasyEDA Pro after each import or upgrade. Extension Manager's success message confirms the installed package, not replacement of a dispatcher already running in memory.
6. Click MCP Bridge → Connect, then MCP Bridge → Status to see the running dispatcher build ID. A reconnect or extension disable/enable alone does not activate an imported update. For version-sensitive operations, verify the active build against your intended package before trusting the new behavior.

3. Manual Client Configurations

If you prefer to configure your clients manually, add the following configuration to the respective settings files:

🟣 Claude Desktop

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" } } } }

🔵 Cursor IDE

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" } } } }

🟢 VS Code (GitHub Copilot)

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" } } } }

🏄 Windsurf (Codeium)

Config Path: ~/.codeium/windsurf/mcp_config.json

{

"mcpServers": { "easyeda-mcp-pro": { "command": "npx", "args": ["-y", "easyeda-mcp-pro@latest"], "env": { "TOOL_PROFILE": "pro" } } } }

🤖 Cline

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": [] } } }

✨ Gemini CLI / Antigravity

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" } } } }

⚡ Zed Editor

Config Path: ~/.config/zed/settings.json

{

"context_servers": { "easyeda-mcp-pro": { "command": { "path": "npx", "args": ["-y", "easyeda-mcp-pro@latest"] }, "settings": {} } } }

🔄 Continue.dev

Config Path: ~/.continue/config.json

{

"mcpServers": { "easyeda-mcp-pro": { "command": "npx", "args": ["-y", "easyeda-mcp-pro@latest"], "env": { "TOOL_PROFILE": "pro" } } } }

👑 Amazon Q Developer

Config Path: ~/.aws/amazonq/mcp.json

{

"mcpServers": { "easyeda-mcp-pro": { "command": "npx", "args": ["-y", "easyeda-mcp-pro@latest"], "env": {