easyeda-mcp-pro

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: the repository is now source-available under PolyForm Noncommercial 1.0.0 rather than an OSI-approved open-source license. Historical OpenSSF evidence remains for audit history and must not be treated as a current FLOSS-license claim.

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 120 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.21.0.
• pnpm: local development and automation require exactly 11.28.0.

Prepare the supported runtime before installing dependencies:

nvm install 24.21.0
nvm use 24.21.0
corepack enable
corepack prepare pnpm@11.28.0 --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 <client>

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 <name>: 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. Click MCP Bridge → Connect in the menu bar.

3. Manual Client Configurations

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

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

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

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