Skip to main content
Glama

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:

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

Herramienta

Propósito

szlcsc_search

Búsqueda por palabra clave / MPN / número C

szlcsc_parametric_search

Filtrado por restricciones de parámetros de ingeniería

szlcsc_get_part

Detalles completos del componente

szlcsc_compare_parts

Comparación de múltiples componentes

szlcsc_find_alternatives

Candidatos alternativos y puntuación

szlcsc_sync_datasheets

Datasheet por lotes + manifest

szlcsc_eda_assets

EasyEDA Symbol / Footprint / OBJ / STEP

szlcsc_altium_setup

Diagnóstico de la cadena de herramientas Altium

szlcsc_altium_smoke_test

Prueba de humo de SchLib/PcbLib/3D/merge

szlcsc_altium_import

Conversión Altium de un solo componente

szlcsc_altium_import_batch

Conversión Altium por lotes

szlcsc_altium_review

Revisión del informe de conversión

szlcsc_library_add

Ingreso a biblioteca a largo plazo + deduplicación CAD + archivo de doble vista

szlcsc_library_status

Estado del índice y clasificación de la biblioteca

szlcsc_library_search

Búsqueda offline en biblioteca a largo plazo con filtro CAD/activos

szlcsc_library_audit

Auditoría de integridad de classified/flat/owner de CAD

szlcsc_library_repair

Corrección segura de mirror/índice con prioridad dry-run

szlcsc_library_sync

Actualización de metadatos de compra como precio/inventario

szlcsc_library_merge

Fusión de SchLib/PcbLib por clasificación

szlcsc_parse_barcode

Decodificación de código QR de bolsa de embalaje LCSC

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.

Available Tools

25 tools
szlcsc_altium_importC

调用本机 altium-cruncher,把指定 C 编号/MPN 的 EasyEDA 数据转换为 Altium SchLib/PcbLib/3D。

Inputs: identifier (required), preview, timeout, output_root, +9 more. Returns: result

szlcsc_altium_import_batchB

批量调用 altium-cruncher 生成 Altium 库;最多 50 个器件,逐个执行并分别报告失败。

Inputs: identifiers (required), preview, timeout, output_root, +3 more. Returns: result

szlcsc_altium_reviewA

读取已生成的 Altium EasyEDA 导入报告,汇总 pin/pad/3D placement 告警,不修改文件。

Inputs: identifier (required), output_root. Returns: result

szlcsc_altium_setupA

返回 Altium 转换工具链诊断和安全安装/升级命令;本工具本身不会执行安装。

Inputs: no named parameters. Returns: result

szlcsc_altium_smoke_testB

实机 Altium 冒烟测试:最多 5 个 C 编号,检查 SchLib/PcbLib/report/可选3D,并可测试合并。

Inputs: identifiers (required), preview, timeout, require_3d, +2 more. Returns: result

szlcsc_altium_statusB

检查可选第三方 altium-cruncher 是否已安装,以及 easyeda-import 子命令是否可用。

Inputs: no named parameters. Returns: result

szlcsc_cache_statusB

查看 SQLite 请求缓存;clear=true 清空;prune_days=N 清理 N 天以前缓存。

Inputs: clear, prune_days. Returns: result

szlcsc_compare_partsA

并排比较多个明确器件,返回基础字段和同名参数差异;不会自动声明可直接替换。

Inputs: identifiers (required). Returns: result

szlcsc_download_partB

下载并整理单个器件:part.json、README.md、datasheet.pdf(若可用)和商品图片。

Inputs: identifier (required), force, output_root. Returns: result

szlcsc_download_partsC

批量下载并整理多个器件完整资料目录。

Inputs: identifiers (required), force, output_root. Returns: result

szlcsc_eda_assetsC

下载 EasyEDA 原始 EDA 资产:CAD JSON、符号/封装 SVG、OBJ/STEP(若该器件提供)。

Inputs: identifier (required), force, include_obj, output_root, +2 more. Returns: result

szlcsc_find_alternativesC

获取 SZLCSC 替代料候选并排序。结果不是 drop-in 兼容声明。

Inputs: identifier (required), max_results, in_stock_only. Returns: result

szlcsc_get_partA

按 C 编号或明确 MPN 获取国内 SZLCSC 详情、参数、库存、价格、商品页和 Datasheet。

Inputs: identifier (required). Returns: result

szlcsc_healthcheckA

轻量检查 SZLCSC 搜索接口与本地缓存是否可用;不读取价格库存详情。

Inputs: query. Returns: result

szlcsc_library_addB

把器件登记进本地库;C编号保留采购元数据,MPN+封装用于 CAD 去重,可按需生成 Altium 库。

Inputs: identifiers (required), preview, timeout, dedupe_cad, +5 more. Returns: result

szlcsc_library_auditB

只读审计长期器件库:检查 classified/flat、CAD owner、索引与文件完整性。

Inputs: identifiers, library_root, verify_hashes. Returns: result

szlcsc_library_mergeB

按库分类把已登记的独立 SchLib/PcbLib 合并成多器件 Altium 库;共享 CAD 只合并一次。

Inputs: timeout, category, conflicts, output_dir, +1 more. Returns: result

szlcsc_library_repairA

安全修复长期器件库;默认 dry-run,只恢复 flat 镜像和 CAD owner/index 一致性,不重新下载或生成 CAD。

Inputs: dry_run, identifiers, repair_flat, library_root, +1 more. Returns: result

szlcsc_library_statusB

查看本地 SZLCSC/Altium 器件库索引、分类、重复 MPN/CAD 组和已登记器件。

Inputs: query, category, library_root, only_cad_owners. Returns: result

szlcsc_library_syncB

刷新库内价格、库存、Datasheet 等采购元数据;不会因这些变化重建 CAD,MPN/封装变化会标记复核。

Inputs: dedupe_cad, identifiers, library_root. Returns: result

szlcsc_parse_barcodeA

解析立创包装袋常见二维码文本(pc=C编号、pm=MPN、qty=数量);lookup=true 时顺便查询器件详情。

Inputs: raw (required), lookup. Returns: result

szlcsc_sync_datasheetsC

批量同步 Datasheet 到一个目录并增量维护 manifest.json;适合 BOM/MPN 列表。

Inputs: identifiers (required), force, output_dir. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 25 tools

    Disambiguation4/5

    Most tools are cleanly separated by domain and action: search, parametric search, get, compare, alternatives, download, Altium import, and library management each have distinct purposes. A few adjacent pairs such as download_parts vs sync_datasheets and library_status vs library_audit require careful description reading, but the boundaries are mostly clear.

    Naming Consistency4/5

    All tools share the szlcsc_ prefix and the majority follow a domain_action pattern such as get_part, library_add, and altium_import. A handful of noun-style names like eda_assets, altium_status, and healthcheck prevent the set from being fully uniform.

    Tool Count3/5

    At 25 tools, the server sits at the upper edge of the heavy range and is larger than typical MCP servers. The count is understandable given the broad scope covering online search, artifact downloads, Altium conversion, and local library management, but it still feels slightly heavy.

    Completeness4/5

    The tool set covers the full workflow from online discovery and comparison to datasheet/EDA download, Altium conversion, and long-term local library management with audit and repair. The main gap is lifecycle management: parts can be added, merged, and synced, but there is no explicit tool to remove a part from the library.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      A
      maintenance
      MCP servers for KiCad schematic, PCB, symbol, footprint, and project automation, enabling AI-assisted electronic design via tools for read/write, analysis, and exports.
      109
      349 PyPI
      16
      GPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for JLCPCB/LCSC component search, live stock and pricing, datasheets, and PCB/3D printing ordering via authenticated API.
      28
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that picks JLCPCB/LCSC parts for KiCad circuits with assembly cost in mind, automating part selection, stock risk checks, and quantity-tiered pricing.
      8
      4
      MIT