SZLCSC MCP

MCP Server orientado a SZLCSC (LCSC nacional), que proporciona búsqueda de componentes, precios/inventario en lotes pequeños en RMB nacional, selección paramétrica, comparación de alternativas, descarga de Datasheet, activos EDA de EasyEDA, conversión de Altium SchLib/PcbLib/STEP y gestión de biblioteca de componentes a largo plazo.

Versión actual: v0.5.0

Capacidades principales

• Búsqueda en szlcsc.com nacional y consulta por número C / MPN.

• Inventario nacional, MOQ, empaque y precios escalonados en RMB; los valores faltantes siempre se mantienen como unknown, no se tratan como 0.

• Búsqueda paramétrica, análisis de unidades de ingeniería, comparación lado a lado de componentes y puntuación de alternativas.

• Sincronización por lotes de Datasheet, diagnóstico de fallos y manifest.

• Obtención de EasyEDA Symbol / Footprint / SVG / OBJ / STEP.

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

• Número C como clave principal para registros de compras, MPN + package como clave de deduplicación para CAD.

• Verificación automática de pin/pad/3D de resultados de conversión Altium + indicación de revisión manual forzada.

Related MCP server: jlcpcb-mcp

v0.5.0: Búsqueda / Auditoría / Corrección de seguridad en biblioteca de componentes a largo plazo

Sobre el archivo de doble vista classified/ + flat/ de v0.4.5, se añaden tres nuevas herramientas de gestión de biblioteca local:

• szlcsc_library_search: Búsqueda completamente offline por número C, MPN, marca, encapsulado, categoría, inventario, estado de Datasheet/SchLib/PcbLib/STEP, con ordenación por relevance/price/stock/mpn.

• szlcsc_library_audit: Verificación de solo lectura de activos principales classified, mirror SHA256 de flat, owner/index de CAD, cad_shared y existencia de archivos Altium.

• szlcsc_library_repair: Por defecto dry_run=true; solo repara mirror de flat y consistencia de owner/index de CAD que se puedan recuperar de forma determinista, no descarga Datasheet de nuevo, ni regenera CAD; la falta de archivos principales classified solo reporta unresolved.

Flujo de mantenimiento recomendado:

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

Los requisitos de prueba formal se han incorporado al repositorio:

• docs/test-plans/FULL_TEST_PLAN.md

• docs/test-plans/ALTIUM_TEST_PLAN.md

• docs/test-plans/RELEASE_ACCEPTANCE.md

v0.4.5: Biblioteca clasificada a largo plazo + Biblioteca de navegación plana

Una vez que los componentes se ingresan en la biblioteca a través de szlcsc_library_add, Datasheet, SchLib, PcbLib y STEP entran simultáneamente en dos vistas:

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/

Por ejemplo:

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

classified/ es el almacenamiento principal a largo plazo: primero se separa por tipo de activo, luego se clasifica por categoría de LCSC. flat/ es un mirror plano, conveniente para visualización directa cuando hay pocos componentes. Si la fuente de datos solo devuelve la categoría de nivel final, solo hay una clasificación de primer nivel; si devuelve la ruta completa primer nivel/segundo nivel/nivel final, se guarda automáticamente por niveles.

szlcsc_library_merge lee preferentemente el archivo classified, por lo que después de eliminar el directorio temporal altium/Cxxxx, los CAD archivados aún se pueden reutilizar y fusionar.

Estado en vivo de Altium

v0.4.4 ha sido verificado en vivo en Windows + Altium Designer:

• altium-cruncher 2026.8.11.1

• altium-monkey 2026.8.11.post1

• wn-geometer 2026.8.11

• easyeda-import: PASS

• merge: PASS

• Descarga/colocación 3D: PASS

• C2040 smoke: PASS

• C2040: 57 pines de Symbol ↔ 57 pads de Footprint, verificación manual de coincidencia

• STEP: 0°, altura de suspensión 0.0 mils, se puede abrir normalmente en Altium Designer

El informe de EasyEDA fuente de C2040 aún conserva la advertencia 51/57 off-grid pin hotspots; esta advertencia no se ha silenciado, pero esta inspección manual no encontró defectos de bloqueo estructural.

Consulte docs/test-reports/v0.4.4-altium-live.md. La regresión local de v0.4.5 fue de 60 passed. Después de la nueva gestión de biblioteca a largo plazo de v0.5.0, es de 67 passed; consulte docs/test-reports/v0.5.0.md.

Instalación

Python 3.11+:

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

Comando MCP:

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

También:

uv tool install .

Opcional: Convertidor Altium

SZLCSC MCP no incluye el altium-cruncher de terceros. En Windows se puede ejecutar:

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

O manualmente:

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

Luego invocar:

szlcsc_altium_setup()
szlcsc_altium_status()

Solo ready=true y status="ready" indican que la cadena de herramientas Altium es comprobable.

Herramientas MCP comunes

Consulte las reglas completas del agente en skills/szlcsc/SKILL.md.

Ejemplos

Selección paramétrica:

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

Ingreso a biblioteca a largo plazo:

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

Búsqueda en biblioteca:

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

Auditoría y corrección:

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

Fusión por clasificación:

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

Datos y principios de seguridad

• Las conclusiones de compra nacional se basan en szlcsc.com, no se reemplazan silenciosamente con precios en USD de LCSC internacional.

• Por defecto, se compara el precio escalonado en RMB correspondiente a la cantidad mínima de compra.

• No se realiza ingeniería inversa, no se evitan captchas, inicio de sesión, firmas WASM ni otros controles de acceso.

• Datasheet admite CDN de adjuntos de LCSC y dominios HTTPS de PDF oficiales de fabricantes controlados; los activos comunes aún están restringidos a dominios SZLCSC/LCSC.

• La conversión automática de EasyEDA/Altium no equivale a una prueba de corrección de fabricación. Antes de enviar a fabricar, aún se debe verificar el Datasheet del fabricante, Pin 1, numeración de pines, tamaño de pads y orientación 3D.

Licencia

MIT. altium-cruncher es una herramienta independiente de terceros que utiliza su propia licencia; este proyecto no incluye su código fuente.