SZLCSC MCP

국내 리창몰 SZLCSC를 위한 MCP 서버로, 부품 검색, 국내 위안화 소량 가격/재고, 파라미터 기반 선정, 대체 부품 비교, 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 배치 / 병합.

• C 번호를 구매 기록 기본 키로, MPN + package를 CAD 중복 제거 키로 사용.

• Altium 변환 결과의 pin/pad/3D 자동 검사 + 강제 수동 검토 안내.

Related MCP server: jlcpcb-mcp

v0.5.0: 장기 부품 라이브러리 검색 / 감사 / 보안 수정

v0.4.5의 classified/ + flat/ 이중 뷰 아카이브 위에 세 가지 로컬 라이브러리 관리 도구가 추가되었습니다:

• 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이 동시에 두 가지 뷰로 저장됩니다:

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단계/2단계/최종 경로를 반환하는 경우 자동으로 단계별로 저장됩니다.

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 다운로드 / 배치: 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 경고가 여전히 남아 있습니다. 이 경고는 무시되지 않았지만 이번 수동 검사에서는 구조적 차단 결함이 발견되지 않았습니다.

자세한 내용은 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 도구

전체 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 방향을 반드시 확인해야 합니다.

라이선스

MIT. altium-cruncher는 독립적인 타사 도구로 자체 라이선스를 사용합니다. 이 프로젝트는 해당 소스 코드를 벤더링하지 않습니다.