SZLCSC MCP

MCP Server for the domestic LCSC (SZLCSC), providing component search, domestic CNY small-batch pricing/stock, parametric selection, alternative part comparison, Datasheet download, EasyEDA EDA assets, Altium SchLib/PcbLib/STEP conversion, and long-term library management.

Current version: v0.5.0

Key Capabilities

• Domestic szlcsc.com search and query by C number / MPN.

• Domestic stock, MOQ, packaging, and CNY tiered pricing; missing values always remain unknown, not treated as 0.

• Parametric search, engineering unit parsing, side-by-side component comparison, and alternative part scoring.

• Datasheet batch sync, failure diagnosis, and manifest.

• EasyEDA Symbol / Footprint / SVG / OBJ / STEP retrieval.

• altium-cruncher-driven SchLib / PcbLib / 3D placement / merge.

• C number as the primary key for procurement records, MPN + package as the CAD deduplication key.

• Automatic pin/pad/3D check of Altium conversion results + mandatory manual review prompt.

Related MCP server: jlcpcb-mcp

v0.5.0: Long-Term Library Search / Audit / Security Fix

On top of the classified/ + flat/ dual-view archive from v0.4.5, three new local library management tools are added:

• szlcsc_library_search: Fully offline search by C number, MPN, brand, package, category, stock, Datasheet/SchLib/PcbLib/STEP status, with sorting by relevance/price/stock/mpn.

• szlcsc_library_audit: Read-only check of classified primary assets, flat mirror SHA256, CAD owner/index, cad_shared, and Altium file existence.

• szlcsc_library_repair: Default dry_run=true; only repairs deterministically recoverable flat mirrors and CAD owner/index consistency, does not re-download Datasheets, does not regenerate CAD; missing classified primary files only reported as unresolved.

Recommended maintenance workflow:

szlcsc_library_audit(...)
        ↓
szlcsc_library_repair(dry_run=true)
        ↓ 人工确认计划
szlcsc_library_repair(dry_run=false)
        ↓
szlcsc_library_audit(...)

Formal test requirements have been included in the repository:

• docs/test-plans/FULL_TEST_PLAN.md

• docs/test-plans/ALTIUM_TEST_PLAN.md

• docs/test-plans/RELEASE_ACCEPTANCE.md

v0.4.5: Categorized Long-Term Library + Flat Browsing Library

After components are added to the library via szlcsc_library_add, Datasheets, SchLib, PcbLib, STEP are simultaneously stored in two views:

szlcsc-library/
├─ library-index.json
├─ classified/
│  ├─ datasheets/<立创类目>/类型-型号-C编号.pdf
│  ├─ schlib/<立创类目>/类型-型号-C编号.SchLib
│  ├─ pcblib/<立创类目>/类型-型号-C编号.PcbLib
│  ├─ 3d/<立创类目>/类型-型号-C编号.step
│  └─ reports/<立创类目>/类型-型号-C编号-*.json
├─ flat/
│  ├─ 类型-型号-C编号.pdf
│  ├─ 类型-型号-C编号.SchLib
│  ├─ 类型-型号-C编号.PcbLib
│  └─ 类型-型号-C编号.step
└─ merged/

For example:

电压基准芯片-TPR3333-S3TR-C5291487.pdf
电压基准芯片-TPR3333-S3TR-C5291487.SchLib
电压基准芯片-TPR3333-S3TR-C5291487.PcbLib
电压基准芯片-TPR3333-S3TR-C5291487.step

classified/ is the long-term primary storage: first separated by asset type, then hierarchically by LCSC category. flat/ is a flat mirror, convenient for direct browsing when there are few components. If the data source only returns the leaf category, only one level of classification is present; if the full Level1/Level2/Leaf path is returned, it is automatically saved level by level.

szlcsc_library_merge reads the classified archive first, so after the temporary altium/Cxxxx conversion directory is deleted, archived CAD can still be reused and merged.

Altium Live Status

v0.4.4 has been verified on a live Windows + Altium Designer setup:

• altium-cruncher 2026.8.11.1

• altium-monkey 2026.8.11.post1

• wn-geometer 2026.6.10

• easyeda-import: PASS

• merge: PASS

• 3D download / placement: PASS

• C2040 smoke: PASS

• C2040: 57 Symbol pins ↔ 57 Footprint pads, manually verified match

• STEP: 0°, 0.0 mils clearance, opens normally in Altium Designer

The source EasyEDA report for C2040 still retains 51/57 off-grid pin hotspots warning; this warning is not silently ignored, but this manual inspection found no structural blocking defects.

See docs/test-reports/v0.4.4-altium-live.md. v0.4.5 local regression: 60 passed. v0.5.0 new long-term library management regression: 67 passed; see docs/test-reports/v0.5.0.md.

Installation

Python 3.11+:

py -3.11 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -U pip
.\.venv\Scripts\pip.exe install -e .

MCP command:

<项目路径>\.venv\Scripts\szlcsc-mcp.exe

Alternatively:

uv tool install .

Optional: Altium Converter

SZLCSC MCP does not bundle the third-party altium-cruncher. On Windows you can run:

powershell -ExecutionPolicy Bypass -File .\scripts\install-altium-cruncher.ps1

Or manually:

uv tool install altium-cruncher
uv tool update-shell
altium-cruncher version

Then call:

szlcsc_altium_setup()
szlcsc_altium_status()

Only when ready=true and status="ready" does it indicate that the Altium toolchain is testable.

Common MCP Tools

Full agent work rules are in skills/szlcsc/SKILL.md.

Examples

Parametric selection:

szlcsc_parametric_search(
  query="3.3V 电压基准",
  package="SOT-23",
  in_stock=true,
  max_price=5,
  constraints={
    "output_voltage": "=3.3V",
    "accuracy": "<=0.2%",
    "tempco": "<=30ppm/°C"
  }
)

Add to long-term library:

szlcsc_library_add(
  identifiers=["C2040", "C5291487"],
  library_root="D:/Components/SZLCSC-Library",
  altium_output_root="D:/Components/Altium",
  import_missing=true,
  dedupe_cad=true
)

Search within library:

szlcsc_library_search(
  library_root="D:/Components/SZLCSC-Library",
  query="TPR3333",
  in_stock=true,
  has_pcblib=true,
  has_step=true,
  sort_by="price"
)

Audit and repair:

szlcsc_library_audit(library_root="D:/Components/SZLCSC-Library")
szlcsc_library_repair(library_root="D:/Components/SZLCSC-Library", dry_run=true)
# 确认 actions 后再 dry_run=false

Merge by classification:

szlcsc_library_merge(
  library_root="D:/Components/SZLCSC-Library",
  output_dir="D:/Components/SZLCSC-Library/merged"
)

Data and Security Principles

• Domestic procurement conclusions are based on szlcsc.com, not silently replaced with international LCSC USD prices.

• Default comparison uses the lowest CNY tiered price corresponding to the minimum purchase quantity.

• No reverse engineering, bypassing of CAPTCHAs, login, WASM signatures, or other access controls.

• Datasheet support includes LCSC attachment CDN and controlled official manufacturer HTTPS PDF domains; general assets remain restricted to SZLCSC/LCSC domains.

• EasyEDA/Altium automatic conversion does not constitute proof of manufacturing correctness. Before submitting for fabrication, you must still verify against manufacturer Datasheets: Pin 1, pin numbers, pad dimensions, and 3D orientation.

License

MIT. altium-cruncher is an independent third-party tool, licensed under its own license; this project does not vendor it.