szlcsc-mcp
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.comnacional 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 + packagecomo 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_sharedy existencia de archivos Altium.szlcsc_library_repair: Por defectodry_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.stepclassified/ 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.1altium-monkey 2026.8.11.post1wn-geometer 2026.8.11easyeda-import: PASSmerge: PASSDescarga/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.exeTambié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.ps1O manualmente:
uv tool install altium-cruncher
uv tool update-shell
altium-cruncher versionLuego 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 |
| Búsqueda por palabra clave / MPN / número C |
| Filtrado por restricciones de parámetros de ingeniería |
| Detalles completos del componente |
| Comparación de múltiples componentes |
| Candidatos alternativos y puntuación |
| Datasheet por lotes + manifest |
| EasyEDA Symbol / Footprint / OBJ / STEP |
| Diagnóstico de la cadena de herramientas Altium |
| Prueba de humo de SchLib/PcbLib/3D/merge |
| Conversión Altium de un solo componente |
| Conversión Altium por lotes |
| Revisión del informe de conversión |
| Ingreso a biblioteca a largo plazo + deduplicación CAD + archivo de doble vista |
| Estado del índice y clasificación de la biblioteca |
| Búsqueda offline en biblioteca a largo plazo con filtro CAD/activos |
| Auditoría de integridad de classified/flat/owner de CAD |
| Corrección segura de mirror/índice con prioridad dry-run |
| Actualización de metadatos de compra como precio/inventario |
| Fusión de SchLib/PcbLib por clasificación |
| 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=falseFusió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 toolsszlcsc_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_searchA
离线检索长期器件库,可按型号/品牌/封装/分类/库存/CAD与归档资产筛选。
Inputs: brand, limit, query, package, +10 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_parametric_searchB
参数化选型。constraints 示例:{"output_voltage":"=3.3V","accuracy":"<=0.2%","tempco":"<=20ppm/°C"}。
Inputs: query (required), constraints (required), brand, package, +4 more. Returns: result
szlcsc_parse_barcodeA
解析立创包装袋常见二维码文本(pc=C编号、pm=MPN、qty=数量);lookup=true 时顺便查询器件详情。
Inputs: raw (required), lookup. Returns: result
szlcsc_searchC
搜索国内立创商城器件,补国内库存和人民币阶梯价。缺失价格/库存保持 unknown,不当作 0。
Inputs: query (required), sort, brand, package, +5 more. 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
Scored across 25 tools
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.
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.
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.
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
Related MCP Connectors
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
MCP registry & directory: search, find & install 31k+ MCP servers & tools. Catalog and marketplace.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseAqualityAmaintenanceMCP servers for KiCad schematic, PCB, symbol, footprint, and project automation, enabling AI-assisted electronic design via tools for read/write, analysis, and exports.109349 PyPI16GPL 3.0
- AlicenseAqualityBmaintenanceMCP server for JLCPCB/LCSC component search, live stock and pricing, datasheets, and PCB/3D printing ordering via authenticated API.282MIT
- AlicenseBqualityCmaintenanceEnables MCP clients to control JLCPCB EDA (嘉立创 EDA) for PCB and schematic design operations through a bridge and plugin architecture.38MIT
- AlicenseAqualityCmaintenanceAn 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.84MIT