SZLCSC MCP

MCP-Server für den inländischen LCSC (SZLCSC) mit Bauteilsuche, inländischen RMB-Kleinmengenpreisen/Beständen, parametrischer Auswahl, Alternativteilevergleich, Datenblatt-Download, EasyEDA-EDA-Assets, Altium-SchLib/PcbLib/STEP-Konvertierung und Langzeit-Bauteilbibliotheksverwaltung.

Aktuelle Version: v0.5.0

Hauptfunktionen

• Inländische szlcsc.com-Suche und Abfrage nach C-Nummer / MPN.

• Inländische Lagerbestände, MOQ, Verpackung und RMB-Stufenpreise; fehlende Werte bleiben stets unknown, werden nicht als 0 behandelt.

• Parametrische Suche, Auflösung technischer Einheiten, nebeneinander Vergleiche von Bauteilen und Bewertung von Alternativen.

• Massen-Synchronisation von Datenblättern, Fehlerdiagnose und Manifest.

• EasyEDA-Symbol/Footprint/SVG/OBJ/STEP-Abruf.

• SchLib/PcbLib/3D-Platzierung/Merge gesteuert durch altium-cruncher.

• C-Nummer als Primärschlüssel für Beschaffungsaufzeichnungen, MPN + package als CAD-Deduplizierungsschlüssel.

• Automatische Pin/Pad/3D-Prüfung der Altium-Ergebnisse + erzwungener Hinweis auf manuelle Überprüfung.

Related MCP server: jlcpcb-mcp

v0.5.0: Langzeit-Bauteilbibliothekssuche / Audit / Sicherheitskorrekturen

Aufbauend auf dem classified/ + flat/ Dual-View-Archiv von v0.4.5 wurden drei neue lokale Bibliotheksverwaltungstools hinzugefügt:

• szlcsc_library_search: Vollständig offline Suche nach C-Nummer, MPN, Hersteller, Gehäuse, Kategorie, Bestand, Datenblatt-/SchLib-/PcbLib-/STEP-Status, mit Sortierung nach Relevanz/Preis/Bestand/MPN.

• szlcsc_library_audit: Schreibgeschützte Prüfung der classified-Hauptbestände, flat-Mirror-SHA256, CAD-Owner/Index, cad_shared und Existenz von Altium-Dateien.

• szlcsc_library_repair: Standardmäßig dry_run=true; repariert nur eindeutig wiederherstellbare flat-Mirror und CAD-Owner/Index-Konsistenz, lädt keine Datenblätter erneut herunter und generiert kein CAD neu; fehlende classified-Hauptdateien werden nur als unresolved gemeldet.

Empfohlener Wartungsablauf:

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

Formelle Testanforderungen sind im Repository enthalten:

• docs/test-plans/FULL_TEST_PLAN.md

• docs/test-plans/ALTIUM_TEST_PLAN.md

• docs/test-plans/RELEASE_ACCEPTANCE.md

v0.4.5: Klassifizierte Langzeitbibliothek + Flache Durchsichtsbibliothek

Nachdem Bauteile mit szlcsc_library_add in die Bibliothek aufgenommen wurden, werden Datenblätter, SchLib, PcbLib und STEP gleichzeitig in zwei Ansichten abgelegt:

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/

Beispiel:

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

classified/ ist der langfristige Hauptspeicher: zuerst nach Asset-Typ getrennt, dann nach LCSC-Kategorie hierarchisch. flat/ ist ein flacher Mirror, der bei wenigen Bauteilen eine direkte Ansicht ermöglicht. Wenn die Datenquelle nur die unterste Kategorie zurückgibt, gibt es nur eine Hierarchieebene; bei vollständigem Ebene1/Ebene2/Unterste-Pfad wird automatisch jede Ebene gespeichert.

szlcsc_library_merge liest bevorzugt das classified-Archiv, sodass nach dem Löschen temporärer altium/Cxxxx-Konvertierungsverzeichnisse archivierte CADs weiterhin wiederverwendet und zusammengeführt werden können.

Altium-Status auf echter Hardware

v0.4.4 wurde auf Windows + Altium Designer auf echter Hardware verifiziert:

• altium-cruncher 2026.8.11.1

• altium-monkey 2026.8.11.post1

• wn-geometer 2026.6.10

• easyeda-import: BESTANDEN

• merge: BESTANDEN

• 3D-Download/Platzierung: BESTANDEN

• C2040 Rauchtest: BESTANDEN

• C2040: 57 Symbol-Pins ↔ 57 Footprint-Pads, manuelle Prüfung auf Übereinstimmung

• STEP: 0°, 0.0 mils Höhe, kann in Altium Designer normal geöffnet werden

Der Quell-EasyEDA-Bericht für C2040 enthält weiterhin die Warnung 51/57 off-grid pin hotspots; diese Warnung wurde nicht stillschweigend ignoriert, aber die manuelle Prüfung ergab keine strukturellen Blockierungsfehler.

Siehe docs/test-reports/v0.4.4-altium-live.md. Die lokale Regression von v0.4.5 ergab 60 bestanden. Nach Hinzufügen der Langzeitbibliotheksverwaltung in v0.5.0 ergab die Regression 67 bestanden; siehe 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-Befehl:

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

Alternativ:

uv tool install .

Optional: Altium-Konverter

SZLCSC MCP bindet kein Drittanbieter-altium-cruncher ein. Unter Windows ausführbar:

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

Oder manuell:

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

Anschließend aufrufen:

szlcsc_altium_setup()
szlcsc_altium_status()

Nur wenn ready=true und status="ready" ist die Altium-Toolchain testbar.

Häufig verwendete MCP-Tools

Vollständige Agent-Arbeitsregeln siehe skills/szlcsc/SKILL.md.

Beispiele

Parametrische Auswahl:

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

In Langzeitbibliothek aufnehmen:

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

In Bibliothek suchen:

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

Audit und Reparatur:

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

Nach Kategorie zusammenführen:

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

Daten- und Sicherheitsprinzipien

• Inländische Beschaffungsergebnisse basieren auf szlcsc.com, werden nicht stillschweigend durch internationale LCSC-US-Dollar-Preise ersetzt.

• Standardmäßig wird der RMB-Stufenpreis der minimalen Bestellmenge verglichen.

• Kein Reverse Engineering, keine Umgehung von Captchas, Logins, WASM-Signaturen oder anderen Zugangskontrollen.

• Datenblätter unterstützen den LCSC-Anhang-CDN und kontrollierte offizielle Hersteller-HTTPS-PDF-Domains; normale Assets bleiben auf SZLCSC/LCSC-Domains beschränkt.

• Automatische EasyEDA/Altium-Konvertierung ist kein Nachweis der Fertigungskorrektheit. Vor der Platinenbestellung muss das Hersteller-Datenblatt, Pin 1, Pin-Nummerierung, Pad-Größen und 3D-Ausrichtung überprüft werden.

Lizenz

MIT. altium-cruncher ist ein unabhängiges Drittanbieter-Tool unter eigener Lizenz; dieses Projekt vendored dessen Quellcode nicht.