SZLCSC MCP

中国国内立创商城 SZLCSC 向けの MCP Server。部品検索、中国国内の人民元での小ロット価格/在庫、パラメトリック選定、代替部品比較、Datasheet ダウンロード、EasyEDA EDA アセット、Altium SchLib/PcbLib/STEP 変換、および長期部品ライブラリ管理を提供します。

現在のバージョン：v0.5.0

主な機能

• 中国国内 szlcsc.com の検索と C 番号 / MPN クエリ。

• 中国国内の在庫、MOQ、パッケージと人民元の段階価格。欠損値は常に unknown のまま保持され、0 として扱われません。

• パラメトリック検索、エンジニアリング単位の解析、部品の並列比較、代替部品のスコアリング。

• Datasheet の一括同期、失敗診断、manifest。

• EasyEDA Symbol / Footprint / SVG / OBJ / STEP の取得。

• altium-cruncher 駆動の SchLib / PcbLib / 3D placement / merge。

• C 番号を調達レコードの主キー、MPN + package を CAD 重複排除キーとして使用。

• Altium 変換結果の pin/pad/3D 自動チェック + 強制的な手動レビューの案内。

Related MCP server: jlcpcb-mcp

v0.5.0：長期部品ライブラリ検索 / 監査 / セキュリティ修正

v0.4.5 の classified/ + flat/ デュアルビューアーカイブの上に、3 つのローカルライブラリ管理ツールを追加しました：

• szlcsc_library_search：完全オフラインで C 番号、MPN、ブランド、パッケージ、分類、在庫、Datasheet/SchLib/PcbLib/STEP ステータスによる検索が可能で、relevance/price/stock/mpn ソートにも対応しています。

• szlcsc_library_audit：classified の主要アセット、flat ミラーの SHA256、CAD owner/index、cad_shared、Altium ファイルの存在を読み取り専用でチェックします。

• szlcsc_library_repair：デフォルトは dry_run=true。確実に復元できる flat ミラーと CAD owner/index の整合性のみを修復します。Datasheet の再ダウンロードはしませんし、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 でライブラリに登録すると、Datasheet、SchLib、PcbLib、STEP が同時に 2 つのビューに入ります：

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/ は長期のプライマリストレージです。まずアセットタイプごとに分離し、次に立创カテゴリの階層に従って分類します。flat/ はフラットなミラーで、部品点数が少ない場合に直接参照しやすい構成です。データソースが最終レベルのカテゴリのみを返す場合は 1 階層の分類のみになります。完全な 一级/二级/末级 パスを返す場合は、階層ごとに自動保存されます。

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 で正常に開けます

C2040 の source EasyEDA レポートには 51/57 off-grid pin hotspots の warning が引き続き残っています。この warning は黙って無視されてはいませんが、今回の手動チェックでは構造的なブロッキング欠陥は見つかりませんでした。

詳細は docs/test-reports/v0.4.4-altium-live.md を参照してください。v0.4.5 のローカルリグレッションは 60 passed です。v0.5.0 では長期ライブラリ管理のリグレッションを追加し、67 passed となりました。詳細は 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 Tools

完全な Agent 作業ルールは 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 の米ドル価格に黙って置き換えることはありません。

• デフォルトでは、最小購入数量に対応する人民元の段階価格を比較します。

• リバースエンジニアリングは行わず、CAPTCHA、ログイン、WASM 署名、その他のアクセス制御を迂回しません。

• Datasheet は立创の添付ファイル CDN と、管理された公式メーカーの HTTPS PDF ドメインをサポートします。通常のアセットは引き続き SZLCSC/LCSC ドメインに制限されます。

• EasyEDA/Altium の自動変換は製造上の正確性の証明にはなりません。基板発注の前に、メーカー Datasheet、Pin 1、ピン番号、パッドサイズ、3D の向きを必ず確認する必要があります。

License

MIT。altium-cruncher は独立したサードパーティ製ツールであり、独自のライセンスを使用します。本プロジェクトはそのソースコードを vendoring しません。