Easyeda Mcp Pro MCP Server

easyeda-mcp-pro

Production-grade MCP server for EasyEDA Pro: safe PCB design inspection, BOM sourcing, manufacturing export, and AI-assisted hardware review.

---

Quick Start

npx easyeda-mcp-pro

Point your MCP client (Claude, Cursor, etc.) to the stdio transport. Create a .env file to configure suppliers and AI providers (see 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 25 MCP tools for schematic inspection, BOM management, design rule checks, PCB board analysis, fabrication exports, 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 >=24 <27 (required for the latest JavaScript features)
• pnpm >=11 (for local development; the npm package is self-contained)
• EasyEDA Pro with the bridge extension installed and running
• For supplier integration: API credentials from JLCPCB, LCSC, Mouser, or DigiKey

---

Installation

Via npm (recommended)

npm install -g easyeda-mcp-pro
easyeda-mcp-pro

Via npx

npx easyeda-mcp-pro

From source

git clone https://github.com/oaslananka/easyeda-mcp-pro.git
cd easyeda-mcp-pro
cp .env.example .env
pnpm install
pnpm build
pnpm start

---

Configuration

Copy .env.example to .env and edit. All variables have safe defaults — only configure what you need.

Essential

Bridge (EasyEDA Pro connection)

Storage

Supplier integration

Enable suppliers by setting their credentials. All suppliers are disabled by default.

• JLCPCB: JLCPCB_MODE=approved_api + client ID/secret
• LCSC: JLCSEARCH_ENABLED=true (default, no key required for basic search)
• Mouser: MOUSER_ENABLED=true + API key
• DigiKey: DIGIKEY_ENABLED=true + OAuth2 client ID/secret

AI Assistance (experimental)

Configure an AI provider for LLM-assisted design review:

HTTP transport

When using TRANSPORT=http:

For production HTTP deployments, configure OAuth (OAUTH_ENABLED=true + issuer/JWKS).

See .env.example for the complete list of 42 configuration variables.

---

MCP Tools

All 25 tools are available via the MCP server. Tools are filtered by the active TOOL_PROFILE.

L0 — Diagnostics (core)

L1 — Schematic (core)

L1 — BOM (core)

L1 — DRC/ERC (core)

L1 — Board (core)

L1 — Export (core/pro)

---

Architecture

┌─────────────────┐     WebSocket      ┌─────────────────────┐
│   AI Assistant   │ ◄──── MCP ──────► │  easyeda-mcp-pro    │
│  (Claude, etc.)  │     Protocol      │  (MCP Server)       │
└─────────────────┘                    │                     │
                                       │  ┌───────────────┐  │
┌─────────────────┐     WebSocket      │  │  BridgeManager │──┼──► EasyEDA Pro
│  EasyEDA Pro     │ ◄── Bridge ──────►│  │  (WS Client)   │  │   (Plugin)
│  (via Plugin)    │     Protocol      │  └───────────────┘  │
└─────────────────┘                    │  ┌───────────────┐  │
                                       │  │  ToolRegistry  │  │
                                       │  │  (25 tools)   │  │
                                       │  └───────────────┘  │
                                       │  ┌───────────────┐  │
                                       │  │    Storage     │──┼──► SQLite
                                       │  │  (Cache/DB)   │  │
                                       │  └───────────────┘  │
                                       │  ┌───────────────┐  │
                                       │  │   Vendors     │──┼──► JLCPCB/LCSC/
                                       │  │ (API Clients) │  │    Mouser/DigiKey
                                       │  └───────────────┘  │
                                       └─────────────────────┘

Transports

• stdio (default): Standard MCP transport — works with Claude Desktop, Cursor, and most MCP clients
• HTTP: Streamable HTTP transport with /healthz, /readyz, /mcp endpoints, CORS, and optional OAuth — suitable for remote deployments

---

Development

# Setup
pnpm install
cp .env.example .env

# Code quality
pnpm format:check          # Prettier
pnpm typecheck             # TypeScript
pnpm lint                  # ESLint

# Test
pnpm test                  # Vitest (73 tests across 12 files)
pnpm test:coverage         # With coverage report

# Build & run
pnpm build                 # tsc -> dist/
pnpm dev                   # Hot-reload dev mode
pnpm start                 # Run compiled build

# MCP Inspector (debug UI)
pnpm inspector

Project structure

src/
├── index.ts                 # Entry point
├── bridge/                  # EasyEDA Pro WebSocket bridge protocol
│   ├── manager.ts, client.ts, extension.ts, protocol.ts, types.ts
├── config/                  # Environment configuration
│   ├── env.ts, profiles.ts, feature-flags.ts
├── schemas/                 # Shared Zod schemas
├── server/                  # MCP server core
│   ├── factory.ts, errors.ts
│   └── transports/
│       └── http.ts          # HTTP/Streamable HTTP transport
├── storage/                 # SQLite storage (cache, artifacts)
├── tools/                   # 25 MCP tool definitions (6 groups)
│   ├── registry.ts, types.ts
│   ├── L0_diagnostics.ts, L1_schematic.ts, L1_bom.ts
│   ├── L1_drc_erc.ts, L1_board.ts, L1_export.ts
└── vendors/                 # Supplier API clients
    ├── lcsc/, jlcpcb/, mouser/, digikey/

---

Security

• Production safety: Validates config at startup — rejects non-loopback HTTP without OAuth, blocks dangerous features in production
• Secret redaction: API keys, tokens, passwords are redacted from logs and diagnostic output
• Branch protection: main branch requires review and up-to-date status checks
• Code scanning: CodeQL analysis runs on every push and PR (security-extended + security-and-quality queries)
• Dependency management: Renovate automatically updates dependencies with security patches
• Reporting: See SECURITY.md for vulnerability disclosure

---

License

MIT

---

Related

• easyeda-bridge — EasyEDA Pro plugin that exposes the bridge WebSocket API
• Model Context Protocol — Standard protocol for AI tool integration
• EasyEDA Pro — Professional PCB design tool