SolidworksMCP

SolidworksMCP는 Windows COM API를 통해 라이브 SOLIDWORKS 세션을 제어하기 위한 프로덕션 지향 Model Context Protocol 서버입니다.

이 프로젝트는 alisamsam/Solidworks-MCP의 포크로, 82개 도구를 143개로 확장하고 도면, 어셈블리 편집, 판금, 제조 패키지 내보내기, 문서 참조 추적을 추가했습니다. 이 포크가 추가한 기능을 참조하세요.

현재 릴리스: 6.5.31. 이 릴리스는 SOLIDWORKS 2026 SP2.1에서 승인 테스트를 거쳤으며 SOLIDWORKS 2025에 대한 호환성 가드를 유지합니다.

주요 기능

• 네이티브 스케치, 피처, 본문, 참조 형상, 뷰, 프로브 및 내보내기 작업.

• 체크포인트, 불변식, 멱등성, 예산 및 롤백을 갖춘 트랜잭션 CAD 계획.

• 명명된 엔터티, 구속조건, 치수, 방정식, 영구 ID 및 자유도 분석을 갖춘 매개변수 스케치.

• 명시적 병합 범위, 간격, 간섭, 경계 상자 및 부피 검증을 갖춘 다중 본문 도구.

• 실루엣 및 선화를 위한 결정론적 래스터-스케치 파이프라인(GPU 기반 분할, 토폴로지 보존, 프리미티브 피팅, 역래스터 품질 게이트 포함).

• 스크린샷 전용 승인이 아닌 네이티브 스케치/본문 내보내기 및 보정된 기하학 비교.

• 검증된 활성 스케치 "정면" 및 "화면 맞춤". 서버는 UI 명령을 신뢰하는 대신 결과 카메라 행렬과 픽셀 점유율을 읽습니다.

• 도면 문서 종단 간: 시트, 뷰, 모델 주석, 수동 치수, 메모, 품번말풍선, 중심 기호 및 BOM 테이블.

• 어셈블리 편집: 구성요소, 구속조건, 패턴, 억제, 교체 및 분해도.

• 기본 플랜지에서 평판 패턴 DXF까지의 판금, 그리고 전체 어셈블리에 대한 STEP, DXF 및 PDF를 내보내는 원콜 제조 패키지.

• 프로젝트 폴더 전체에서 사용처 검색을 포함한 문서 검색 및 참조 추적(양방향).

• 구조화된 진단, 모달 대화상자 사전 점검, 범위가 좁은 수정 감시자, 유한 복구 정책.

Related MCP server: solidworks-mcp

이 포크가 추가한 기능

이 저장소는 alisamsam/Solidworks-MCP의 포크입니다. 업스트림 릴리스는 스케치, 솔리드 피처, 본문, 프로브, 벡터화 및 트랜잭션 계층을 다루는 82개 도구를 노출했습니다. 이 포크는 이를 143개 도구로 늘리고 테스트 스위트를 155개에서 382개 테스트로 확장했으며 모두 통과합니다.

추가 사항은 업스트림 프로젝트가 이미 확립한 규율을 따릅니다. 즉, COM 반환 값을 신뢰하지 않습니다. 모든 새 작업은 결과 상태(주석 수, 구성요소 목록, 억제 플래그, 면 수, 디스크의 파일)를 다시 읽어 API가 성공을 보고할 때가 아니라 모델이 실제로 변경 사항을 표시하지 않을 때 실패를 보고합니다.

도면 (17개 도구)

업스트림에는 도면 문서 지원이 전혀 없었습니다. 이 포크는 전체 디테일링 경로를 다룹니다: create_new_drawing, add_sheet, activate_sheet, list_sheets, insert_drawing_view, insert_standard_views, insert_section_view, insert_detail_view, list_drawing_views, set_view_scale, insert_model_annotations, insert_bom_table, add_drawing_dimension, insert_drawing_note, insert_balloons, insert_center_marks, list_drawing_annotations.

뷰와 주석은 시트에 나타난 항목 수를 세어 확인합니다. CreateDrawViewFromModelView3 및 InsertModelAnnotations3는 모두 생성되지 않은 뷰와 주석에 대해 성공을 보고합니다.

어셈블리 (14개 도구)

업스트림은 어셈블리 열기에서 멈췄습니다. 이 포크는 구성요소 및 구속조건 작업을 추가합니다: insert_component, list_components, add_mate, delete_mate, list_mates, set_component_fixed, check_assembly_interference, delete_component, replace_component, set_component_suppression, pattern_components, explode_assembly, show_exploded, list_exploded_views.

판금 (6개 도구)

판금은 산출물이 솔리드가 아니라 평판 패턴(레이저나 터렛이 소비하는 DXF)인 유일한 부품 분야입니다. create_base_flange는 스케치를 판금 본체로 두껍게 만들고, convert_to_sheet_metal은 기존 솔리드를 판금으로 변환합니다. 굽힘 브래킷의 STEP에는 굽힘 정보가 없으므로 가져온 형상이 거쳐야 하는 경로입니다. create_edge_flange는 프로필 스케치 없이 모서리에서 플랜지를 구부리고, set_flat_pattern은 평평하게 펴거나 접고, export_flat_pattern은 DXF 또는 DWG를 씁니다. get_sheet_metal_info는 견적이나 네스팅 실행에 필요한 두께, 반경, K-계수 및 평판 패턴 범위를 보고합니다.

ExportFlatPatternView는 평판 패턴을 만들지 못한 부품에 대해 성공을 보고하므로 내보내기는 디스크의 파일에 대해 확인됩니다. 평판 패턴 피처는 표시 이름이 지역화되므로 표시 이름이 아닌 API 유형 이름으로 찾습니다.

제조 패키지 (1개 도구)

export_manufacturing_package는 한 번의 호출로 상점이 실제로 받는 폴더를 생성합니다: 각 부품과 어셈블리에 대한 STEP, 각 판금 부품에 대한 DXF, 각 모델 옆에 있는 도면의 PDF, 각 부품의 재질과 질량을 나열하는 manifest.json. 어셈블리를 구성요소별로 탐색하므로 20개 부품 기계는 60번이 아닌 한 번의 호출로 처리됩니다. 열어야 했던 문서는 나중에 다시 닫히고 원래 활성 문서가 복원됩니다.

문서 검색 및 참조 (3개 도구)

search_documents는 이름 조각과 유형으로 폴더에서 SolidWorks 파일을 찾습니다. list_document_references는 문서가 사용하는 항목과 해당 파일이 여전히 디스크에 있는지 여부를 보고합니다. find_where_used는 반대 질문(이 부품을 사용하는 어셈블리와 도면)에 답합니다. 문서는 참조하는 항목만 기록하고 참조하는 항목은 기록하지 않으므로 SolidWorks가 직접 답할 수 없는 질문입니다. 역방향 맵은 폴더 트리의 모든 어셈블리 및 도면의 종속성을 읽어 구축되며, GetDocumentDependencies2가 파일을 열지 않고 참조를 읽기 때문에 가능합니다.

피처 (5개 도구)

create_loft, create_rib, apply_draft, simple_hole, hole_wizard 각각에는 죽은 피처 가드가 있습니다. 형상을 추가하지 않고 성공을 보고하는 피처는 트리에 남는 대신 삭제됩니다.

구성, 속성 및 매개변수 (15개 도구)

activate_configuration, list_configurations, list_custom_properties, set_custom_property, delete_custom_property, get_material, set_material, get_mass_properties, get_dimension, set_dimension, add_equation, set_equation, delete_equation, list_equations, rebuild_document.

ShowConfiguration2는 검증된 거짓말쟁이 중 하나입니다. 활성화되지 않은 구성에 대해 성공을 반환하므로 활성 구성은 이후에 다시 읽힙니다.

도구 외

• 도구 스키마는 server.py에서 schemas/ 패키지로 이동하여 제품군별로 그룹화되어 server.py가 3819줄에서 2300줄로 줄었습니다.

• 패키징 메타데이터(pyproject.toml), 멀티 기가바이트 PyTorch 백엉용 별도 vision 엑스트라, 스위트를 실행하는 GitHub Actions 워크플로.

• LICENSE는 두 저작권 보유자와 포크가 변경한 사항을 기록합니다.

요구 사항

• Windows 10 또는 Windows 11.

• SOLIDWORKS 2025 또는 2026, 설치 및 라이선스 필요.

• Python 3.10 이상; Python 3.11이 승인 테스트 런타임입니다.

• 패키지된 선화 체크포인트용 Git LFS.

• 딥 벡터화 모드에는 NVIDIA CUDA 환경을 적극 권장합니다. get_capabilities는 실제 백엔드 상태를 보고합니다.

서버는 대화형 SOLIDWORKS 프로세스를 구동합니다. 헤드리스 CAD 커널이 아니며, 알 수 없는 모달 대화상자는 사람이 검사해야 합니다.

복제 및 설치

복제하기 전에 Git LFS를 설치하거나 나중에 모델 개체를 가져오세요:

git lfs install
git clone https://github.com/aryesil/SolidworksMCP.git
Set-Location SolidworksMCP
git lfs pull

격리된 Python 환경을 만들고 패키지를 설치합니다:

py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
python -m pip install -e .

기본 설치는 딥 실루엣 벡터화를 제외한 모든 도구를 다룹니다. PyTorch 백엔드는 vision 엑스트라에 있습니다:

python -m pip install -e ".[vision]"

CUDA 휠은 대부분의 도구가 건드리지 않는 설치에 수 기가바이트를 추가하므로 엑스트라는 별도입니다. 기본 휠이 일치하지 않으면 머신의 CUDA 드라이버에 적합한 PyTorch 빌드를 먼저 설치하세요. get_capabilities는 실제로 활성화된 백엔드를 보고합니다.

requirements.txt는 패키지 메타데이터 없이 설치하는 사용자를 위해 기본 종속성을 계속 나열합니다.

MCP 구성

가상 환경의 Python 실행 파일을 사용하여 MCP 클라이언트를 저장소 진입점으로 지정합니다:

{
  "mcpServers": {
    "SolidworksMCP": {
      "command": "C:\\path\\to\\SolidworksMCP\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\SolidworksMCP\\solidworks_mcp_server.py"
      ]
    }
  }
}

SOLIDWORKS를 시작하고 MCP 클라이언트를 다시 시작하거나 다시 연결한 다음, 본격적인 모델링 작업 전에 get_capabilities 및 get_environment_status를 호출하세요.

안정적인 호환성 식별자

SolidworksMCP는 공개 프로젝트 및 MCP 핸드셰이크 이름입니다. Python 패키지는 solidworks_mcp로 유지되고, 구성된 도구 네임스페이스는 solidworks로 유지되며, 기존 아티팩트 스키마는 solidworks-mcp/... 식별자를 유지합니다. 이러한 내부 이름은 호환성 계약이므로 의도적으로 이름을 바꾸지 않습니다.

작업 제품군

서버는 작은 네이티브 작업과 고급 검증 워크플로를 모두 노출합니다. 중요한 제품군은 다음과 같습니다:

• 문서 및 환경: 생성/열기/저장/닫기, 기능, 세션 메트릭, 모달 상태 검사, 복구;

• 스케치: 표준 평면, 평면 면, 정확한 모델 좌표 윤곽, 프리미티브 그리기, 매개변수 스케치, 치수, 구속조건, 방정식;

• 피처: 검증된 돌출/컷, 회전, 스윕, 필렛, 모따기, 셸, 미러, 패턴, 참조 축 및 평면;

• 본문: 가시성, 이름 지정, 모양, 부피, 간격, 간섭, 다중 본문 삽입 워크플로;

• 검증: 광선/단면 프로브, 스케치 토폴로지, 네이티브 지오메트리 내보내기, 스케치 간 및 보정된 이미지 비교, 본문 실루엣;

• 벡터화: 선택 가능한 실루엣/영역/선화 모드, 딥 세그멘테이션, 제어 가능한 근사, CAD 커밋 및 역래스터 검증;

• 도면: 시트, 모델 및 표준 뷰, 단면 및 세부 뷰, 모델 주석, 수동 치수, 메모, 품번말풍선, 중심 기호, BOM 테이블;

• 어셈블리: 구성요소 삽입 및 삭제, 구속조건, 교체, 억제, 구성요소 패턴, 분해도, 간섭 검사;

• 판금: 기본 플랜지, 가져온 솔리드 변환, 엣지 플랜지, 평판 패턴 상태, DXF/DWG 평판 패턴 내보내기, 판금 매개변수;

• 제조 출력: 부품 또는 전체 어셈블리에 대한 매니페스트가 포함된 STEP, DXF 및 PDF의 원콜 패키지 내보내기;

• 디스크의 문서: 이름 및 유형별 파일 검색, 누락 파일 감지가 포함된 나가는 참조, 폴더 트리 전체의 사용처;

• 구성 및 매개변수: 구성, 사용자 지정 속성, 재질, 질량 속성, 치수, 방정식;

• 오케스트레이션: 트랜잭션, 선언적 CAD 계획, 의미 체계 기본 요소, 모델 그래프 동기화, 원자적 내보내기 번들.

권위 있는 라이브 스키마는 MCP 도구 검색을 사용하세요. 도구 설명과 get_capabilities는 서버와 함께 버전이 지정됩니다.

안전 규칙

• 저장되지 않은 문서의 첫 번째 변경 전에 절대 save_path를 제공하거나 allow_unsaved_document=true로 일회용 작업을 명시적으로 선택하세요.

• success를 실행 증거로 취급하세요. 토폴로지, 본문 수, 경계 상자, 부피, 공차 및 읽을 수 있는 독립 아티팩트를 확인하세요.

• 다중 본문 컷 및 보스에는 scope_bodies 및 expected_merge_bodies를 사용하세요.

• 알 수 없는 대화상자를 자동으로 확인하지 마세요. 인식된 작업 범위 치수 수정 대화상자만 감시자가 처리할 수 있습니다.

• 네이티브 MCP 도구 좌표는 선언된 사용자 단위(일반적으로 밀리미터)를 사용합니다. 원시 SOLIDWORKS COM 좌표는 미터를 사용합니다.

• 스케치 작업 후 맹목적으로 Ctrl+8을 호출하지 마세요. 버전 6.5.31은 이미 안정적인 측면/위쪽 방향과 작업 형상 맞춤을 적용하고 확인합니다.

벡터화 모델

결정적 선화(checkpoint)는 solidworks_mcp/models/lineart/ 아래에 있으며 Git LFS로 저장됩니다:

• dexined_biped_v2.pt

• teed_biped_5.pt

이들의 출처와 라이선스 고지는 solidworks_mcp/models/lineart/LICENSES.md에 문서화되어 있습니다. 바이너리 객체 대신 작은 LFS 포인터 파일만 포함된 클론은 불완전합니다. 서버를 시작하기 전에 git lfs pull을 실행하세요.

SOLIDWORKS Autotrace/Picture to Sketch는 대화형 PropertyManager 기능이며 지원되는 공개 API 진입점이 없습니다. 따라서 이 서버는 자체 결정적 세그멘테이션 및 선화 파이프라인을 사용합니다.

구성

기본 런타임 설정은 solidworks_mCP/config.json에 저장됩니다. 시스템별 또는 민감한 재정의는 config.local.json에 보관하세요. 이 파일은 Git에서 무시됩니다.

주요 기본값은 다음과 같습니다:

• 자동 SOLIDWORKS 실행 파일 및 템플릿 검색;

• 사용자 단위로 밀리미터 사용;

• 작업 범위의 치수 대화상자 가드;

• 제한된 트랜잭션/런타임 한도;

• 자동 체크포인트 디렉터리 관리;

• INFO 수준 파일 로깅.

상대 log_file 값은 소스 체크아웃이 아닌 %LOCALAPPDATA%\SolidworksMCP\ 아래에 기록됩니다. config.json의 절대 경로도 계속 지원됩니다.

테스트

저장소에는 결정적 단위 및 회귀 테스트 스위트가 포함되어 있습니다:

python -m unittest discover -s tests -p "test_*.py"

이 스위트는 382개 테스트를 통과합니다. 이러한 테스트는 COM 동작에 대한 실사용 승인을 대체하지 않습니다. 다른 SOLIDWORKS 메이저 버전을 검증할 때는 표준 평면, 평면형 면, 기존 스케치 활성화, 뷰 복구, 피처, 트랜잭션, 벡터화 및 내보내기도 다루어야 합니다.

프로젝트 구조

SolidworksMCP/
|-- solidworks_mcp_server.py       MCP stdio entry point
|-- requirements.txt
|-- LICENSE
|-- solidworks_mcp/
|   |-- server.py                  MCP dispatch and handlers
|   |-- schemas/                   tool schemas, grouped by family
|   |-- tool_registry.py           high-level tool metadata
|   |-- vector_worker.py           isolated scientific worker
|   |-- config.py / config.json
|   |-- constants.py
|   |-- automation/                SOLIDWORKS COM implementation
|   |-- models/lineart/            Git-LFS checkpoints and licenses
|   `-- utils/
`-- tests/
    `-- test_v6.py                 unit and regression suite

런타임 로그, 캐시, 로컬 클라이언트 설정, 체크포인트, 생성된 보고서, 승인 산출물 및 수동 프로브는 의도적으로 저장소에서 제외됩니다.

라이선스

서버는 MIT 라이선스에 따라 배포됩니다. LICENSE를 참조하세요. 패키징된 모델 고지는 solidworks_mcp/models/lineart/LICENSES.md에 별도로 보존됩니다.

이 저장소는 Samsaam Ali Baig의 alisamsam/Solidworks-MCP 포크입니다. 원본 저작권 고지는 유지되며, 여기서 이루어진 수정 사항은 동일한 MIT 라이선스에 따라 공개됩니다. LICENSE는 두 저작권 보유자를 모두 기록하고 이 포크가 추가하는 내용을 요약합니다.