SZLCSC MCP

MCP-сервер для китайской платформы LCSC (SZLCSC), предоставляющий поиск компонентов, мелкосерийные цены и наличие на складе в юанях, параметрический подбор, сравнение альтернатив, загрузку даташитов, ресурсы EasyEDA EDA, конвертацию в Altium SchLib/PcbLib/STEP и управление долгосрочной библиотекой компонентов.

Текущая версия: v0.5.0

Основные возможности

• Поиск на китайском szlcsc.com по C-номеру / MPN.

• Наличие на складе в Китае, MOQ, упаковка и ступенчатые цены в юанях; отсутствующие значения всегда остаются unknown, не заменяются нулём.

• Параметрический поиск, разбор инженерных единиц, параллельное сравнение компонентов и оценка альтернатив.

• Пакетная синхронизация даташитов, диагностика ошибок и манифест.

• Получение EasyEDA Symbol / Footprint / SVG / OBJ / STEP.

• SchLib / PcbLib / 3D placement / merge на основе altium-cruncher.

• C-номер как первичный ключ для закупочных записей, MPN + package как ключ дедупликации для CAD.

• Автоматическая проверка pin/pad/3D результатов конвертации Altium + обязательное напоминание о ручной проверке.

Related MCP server: jlcpcb-mcp

v0.5.0: Поиск / аудит / исправление безопасности долгосрочной библиотеки

На основе архива с двойным представлением classified/ + flat/ из v0.4.5 добавлены три новых инструмента управления локальной библиотекой:

• szlcsc_library_search: полностью офлайн-поиск по C-номеру, MPN, бренду, корпусу, категории, наличию, статусу даташита/SchLib/PcbLib/STEP с сортировкой по релевантности/цене/наличию/MPN.

• szlcsc_library_audit: проверка только на чтение основных активов classified, SHA256 зеркала flat, владельца/индекса CAD, cad_shared и существования файлов Altium.

• szlcsc_library_repair: по умолчанию dry_run=true; исправляет только восстанавливаемые зеркала flat и согласованность владельца/индекса CAD, не перезагружает даташиты и не перегенерирует CAD; отсутствие основных файлов classified только сообщается как unresolved.

Рекомендуемый процесс обслуживания:

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

Требования к формальному тестированию включены в репозиторий:

• docs/test-plans/FULL_TEST_PLAN.md

• docs/test-plans/ALTIUM_TEST_PLAN.md

• docs/test-plans/RELEASE_ACCEPTANCE.md

v0.4.5: Классифицированная долгосрочная библиотека + плоская просмотровая библиотека

После добавления компонентов в библиотеку через szlcsc_library_add даташиты, SchLib, PcbLib, STEP попадают в два представления:

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/

Например:

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

classified/ — долгосрочное основное хранилище: сначала разделение по типу актива, затем по категориям LCSC. flat/ — плоское зеркало, удобное для прямого просмотра при небольшом количестве компонентов. Если источник данных возвращает только конечную категорию, будет только один уровень классификации; если возвращается полный путь первый/второй/конечный, категории создаются автоматически на каждом уровне.

szlcsc_library_merge сначала читает архив classified, поэтому после удаления временного каталога конвертации altium/Cxxxx уже заархивированные CAD-файлы продолжают использоваться и объединяться.

Состояние Altium на реальном оборудовании

v0.4.4 прошла проверку на реальном оборудовании Windows + Altium Designer:

• 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 ↔ 57 контактных площадок Footprint, ручная проверка совпадения

• STEP: 0°, 0.0 mils высота, Altium Designer открывается нормально

Исходный отчёт EasyEDA для C2040 по-прежнему содержит предупреждение 51/57 off-grid pin hotspots; это предупреждение не игнорируется молча, но при ручной проверке не обнаружено структурных блокирующих дефектов.

Подробнее см. docs/test-reports/v0.4.4-altium-live.md. Локальная регрессия v0.4.5: 60 пройдено. После добавления управления долгосрочной библиотекой в v0.5.0: 67 пройдено; подробнее см. docs/test-reports/v0.5.0.md.

Установка

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:

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

Также можно:

uv tool install .

Опционально: конвертер Altium

SZLCSC MCP не включает сторонний altium-cruncher. На Windows можно запустить:

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

или вручную:

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

Затем вызвать:

szlcsc_altium_setup()
szlcsc_altium_status()

Только если ready=true и status="ready", инструментарий Altium считается готовым к тестированию.

Часто используемые инструменты MCP

Полные правила работы агента см. в skills/szlcsc/SKILL.md.

Примеры

Параметрический подбор:

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

Добавление в долгосрочную библиотеку:

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

Поиск в библиотеке:

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

Аудит и исправление:

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

Объединение по категориям:

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

Принципы работы с данными и безопасность

• Выводы о закупках в Китае основываются на szlcsc.com, не заменяются молча на международные цены LCSC в долларах.

• По умолчанию сравнивается ступенчатая цена в юанях для минимального количества заказа.

• Не производится реверс-инжиниринг, обход капчи, входа, подписи WASM или других средств контроля доступа.

• Даташиты поддерживают CDN вложений LCSC и контролируемые домены официальных производителей по HTTPS PDF; обычные активы ограничены доменами SZLCSC/LCSC.

• Автоматическая конвертация EasyEDA/Altium не является доказательством корректности для производства. Перед отправкой платы необходимо сверяться с даташитом производителя, Pin 1, нумерацией выводов, размерами контактных площадок и ориентацией 3D.

Лицензия

MIT. altium-cruncher — независимый сторонний инструмент, распространяемый под собственной лицензией; данный проект не включает его исходный код.