SolidWorks MCP Server 🔧

Claude에서 자연어로 SolidWorks를 조작하는 MCP 서버 Control SolidWorks from Claude with natural language (Model Context Protocol)

한국어 · English

이 저장소는 alisamsam/Solidworks-MCP (MIT, Samsaam Ali Baig)를 바탕으로 Windows 원클릭 설치, SolidWorks 2025 COM 호환성 수정, 한국어 SolidWorks 지원을 더한 버전입니다.

Based on alisamsam/Solidworks-MCP (MIT, Samsaam Ali Baig), with a one-click Windows installer, SolidWorks 2025 COM fixes and support for localized (e.g. Korean) SolidWorks.

Design Studio: 역설계 · 근거 DB · 사용자 검토 · 설계 개선

CLI와 Claude/Codex에서 조사 → 증거 → 구체적 형상·치수 → 대안 비교 → 정량·외형 검토 → 개선을 진행합니다. 품질 우선 RAG, SQLite 증거/설계 이력, 계산 재검증, 사용자 검토 패킷을 추가했습니다. 기존 CAD·검증 도구 35개(표준 검증 배터리 verify_model 포함)를 유지하고 Windows 서버에 Design Studio 도구 17개를 더했습니다. 독립 서버의 16개 도구는 macOS/Linux에서도 실행되며, 실제 CAD 조작·native capture는 Windows에서 합니다.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .
sw-design doctor --mcp
sw-design demo --output ./sensor-front-example
sw-design connect --client codex --apply
sw-design start sensor-front-demo --agent codex

Windows에서는 .venv\Scripts\python.exe -m pip install -e ".[cad]"와 .venv\Scripts\sw-design.exe를 사용합니다. connect --client claude-code --apply도 지원합니다. 예제는 가정 기반의 실제 계산 반복이며 제품 실측·해석·승인 결과가 아닙니다.

전체 사용법·예제·검토 과정 · 구현 계획 · 품질 정책 · 표준 적용 범위

Related MCP server: solidworks-mcp-python

설치: Claude에게 한 마디 · Install: just ask Claude

"https://github.com/hayward2007/solidworks-mcp 설치해줘" · "Install https://github.com/hayward2007/solidworks-mcp"

Claude Code(Windows)는 바로 설치하고, Claude Desktop(Cowork)은 더블클릭할 설치 파일을 주고 설계 스킬 저장 카드를 띄워요. 직접 하려면 PowerShell에 이 한 줄을 붙여 넣으세요. Claude Code on Windows installs it right away; Claude Desktop (Cowork) gives you an installer to double-click and offers the design skill to save. To do it yourself, paste this line into PowerShell:

irm https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/install.ps1 | iex

끝나면 SolidWorks를 열고, Claude Desktop을 트레이 아이콘 → 종료(Quit)로 완전히 끈 뒤 다시 켜세요. Then open SolidWorks, fully quit Claude Desktop (tray icon → Quit) and start it again.

The server has to run on the user's Windows PC next to SolidWorks; never install it inside a Linux VM or a cloud container.

1. If you can run commands on that PC (Claude Code on Windows; from WSL call powershell.exe), run:

   powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/install.ps1 | iex"

   It puts the code in %USERPROFILE%\solidworks-mcp (or updates it), creates .venv, installs the requirements, self-tests the server (52 tools, including Design Studio), registers solidworks in Claude Desktop and in Claude Code (claude mcp add --scope user) and copies the skill to ~/.claude/skills/solidworks-design. The first run takes a few minutes; success ends with All set.

   • If it reports Python 3.10 or newer (64-bit) was not found, ask the user, then install Python 3.13 with winget and continue: powershell -NoProfile -ExecutionPolicy Bypass -Command "& ([scriptblock]::Create((irm https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/install.ps1))) -InstallPython"

   • Other options go in the same place: -InstallDir <path>, -NoClaudeDesktop, -NoClaudeCode, -NoSkill, -Uninstall.

2. If you cannot run Windows programs (Claude Desktop / Cowork, where your shell is a Linux VM or a cloud container):

   • Download https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/setup_windows.bat, save it into a folder the user connected (or send it as a file) and ask them to double-click it. It runs the same installer and asks before installing Python. Pasting the PowerShell line above works too.

   • Offer the design skill: propose the contents of skills/solidworks-design/SKILL.md as a new skill named solidworks-design for the user to save. Cowork does not pass MCP server instructions to the model; this skill brings in the working rules.

3. Afterwards ask the user to open SolidWorks and to fully quit Claude Desktop (tray icon → Quit) and start it again; in Claude Code a new session is enough. The solidworks tools should then be available (knowledge_get("agent-guide") is a quick check). If they are not, read setup_mcp.log in the install folder and run the installer again while Claude Desktop is closed.

한국어

목차

1. 소개

2. 원본 대비 변경 사항

3. 요구 사항

4. 빠른 시작

5. 설치 스크립트가 하는 일

6. 수동 설정

7. 사용 방법

8. Text-to-CAD 작업 흐름

9. 도구 목록

10. execute_python 고급 사용

11. 설계 지식 베이스

12. 기어 생성기

13. 토폴로지 최적화

14. 설정 파일 config.json

15. 문제 해결

16. 업데이트와 제거

17. 로드맵

18. 프로젝트 구조

19. 라이선스와 크레딧

소개

SolidWorks MCP Server는 Claude 같은 AI 에이전트가 SolidWorks를 직접 조작하게 해 주는 Model Context Protocol 서버예요. 메뉴를 클릭하는 대신 만들고 싶은 형상을 말로 설명하면, Claude가 SolidWorks COM API로 파트를 만들고 스케치를 그리고 피처를 추가해요.

• 도구 52개 (CAD·검증 35 + Design Studio 17): 연결, 문서, 스케치, 피처, 유틸리티, SolidWorks API를 직접 실행하는 execute_python, 검증(Text-to-CAD), 설계 지식 검색, 기어 생성, 토폴로지 최적화

• 에이전트용 작업 규칙(토큰 절약, 설계 근거)이 매 세션 자동 적용돼요

• SolidWorks 2023–2025 지원, 설치 경로 자동 탐지(레지스트리)

• 단위: mm, cm, m, inch, ft (기본 mm)

• 동작 로그: solidworks_mcp/solidworks_mcp.log

원본 대비 변경 사항

요구 사항

• Windows 10 / 11 (64비트)

• SolidWorks 2023–2025 (설치 및 라이선스 필요)

• Python 3.10 이상(64비트): python.org 설치판 또는 Python Install Manager(py) 모두 돼요. 없으면 설치 스크립트가 winget으로 Python 3.13을 설치해 줄 수 있어요

• Claude Desktop 또는 Claude Code

• 처음 설치할 때 인터넷 연결 (pip 패키지 다운로드, 토폴로지 최적화용 numpy·scipy 포함 약 60 MB)

검증 환경: SolidWorks 2025 (revision 33.5.0, 한국어 UI), Python 3.14.7, Claude Desktop (Windows, Microsoft Store/MSIX 설치판).

빠른 시작

가장 쉬운 방법은 맨 위처럼 Claude에게 설치해 달라고 하는 거예요. 직접 하려면:

1. 설치 스크립트 실행: PowerShell에 한 줄을 붙여 넣으세요.

   irm https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/install.ps1 | iex

   코드는 %USERPROFILE%\solidworks-mcp에 받아요. 저장소를 직접 받았다면(git clone https://github.com/hayward2007/solidworks-mcp.git 또는 ZIP) 그 폴더의 setup_windows.bat을 더블클릭해도 돼요. 마지막에 All set이 나오면 끝이에요. 폴더 경로가 Claude 설정에 기록되니까, 나중에 폴더를 옮기면 다시 실행하세요.

2. Claude Desktop 완전히 종료 후 다시 실행: 작업 표시줄 오른쪽 아래 트레이(^ 안쪽일 수 있음)의 Claude 아이콘을 우클릭해서 종료(Quit) 를 누르고 다시 켜세요. 창만 닫으면 백그라운드에서 계속 돌아가서 새 설정을 읽지 않아요. Claude Code는 새 세션을 시작하면 돼요.

3. SolidWorks를 열고 Claude에게 "SolidWorks에 연결해줘"라고 말하세요.

Claude의 설정(Settings) → 개발자(Developer)에서 solidworks 서버가 running으로 보이면 정상이에요.

Cowork를 쓴다면 설계 스킬도 저장하세요. Cowork는 서버 instructions(작업 규칙)를 모델에 넘기지 않아서, solidworks-design 스킬이 그 규칙을 불러와요. Cowork에서 Claude에게 "https://github.com/hayward2007/solidworks-mcp 의 solidworks-design 스킬 저장해줘"라고 하면 저장 카드가 떠요. claude.ai에서는 설치 스크립트가 만든 dist\solidworks-design.zip을 설정 → Capabilities → Skills에서 올려도 돼요. Claude Code에는 설치 스크립트가 ~/.claude/skills에 넣어 줘요.

설치 스크립트가 하는 일

1. 코드를 받아요: %USERPROFILE%\solidworks-mcp에 git clone(git이 없으면 GitHub ZIP)하고, 이미 있으면 업데이트해요. 저장소 안의 setup_windows.bat으로 실행하면 그 폴더를 그대로 써요.

2. 64비트 Python 3.10 이상을 찾아요: py -0p 목록 → py -3 → PATH의 python → %LOCALAPPDATA%\Python\pythoncore-3.*, %LOCALAPPDATA%\Programs\Python\Python3*, %ProgramFiles%\Python3* 순서예요. numpy·scipy·pywin32 휠이 있는 3.10–3.14 중 가장 새 버전을 골라요. 없으면 winget으로 Python 3.13을 설치할지 물어봐요(-InstallPython이면 묻지 않고 설치).

3. 프로젝트 폴더에 가상환경 .venv를 만들어요 (이미 있으면 다시 써요).

4. requirements.txt를 설치해요 (mcp 1.x, pywin32, python-dotenv, Pillow, numpy, scipy).

5. 서버 자가 진단: Claude Desktop과 같은 방식(stdio)으로 서버를 띄워서 MCP 초기화와 도구 목록(51개)을 확인해요.

6. Claude Desktop 설정 파일에 solidworks 서버를 등록해요. 다른 서버와 설정은 그대로 두고, 바꾸기 전에 claude_desktop_config.json.bak-날짜-시간 백업을 만들어요. Microsoft Store(MSIX) 설치판의 설정 위치도 함께 갱신해요.

7. Claude Code(claude CLI)가 있으면 claude mcp add --scope user로 등록하고 설계 스킬을 ~/.claude/skills/solidworks-design에 복사해요. Claude Desktop·claude.ai에 올릴 dist\solidworks-design.zip도 만들어요.

8. 화면에 나온 내용을 setup_mcp.log에 저장해요.

여러 번 실행해도 안전해요. 이미 등록돼 있으면 already up to date가 나와요. 옵션: -InstallDir 경로, -InstallPython, -NoClaudeDesktop, -NoClaudeCode, -NoSkill, -Uninstall. setup_windows.bat에도 그대로 넘길 수 있어요(예: setup_windows.bat -Uninstall).

수동 설정

1) 패키지 설치

cd C:\경로\Solidworks-MCP
py -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt

2) Claude Desktop

Claude → 설정 → 개발자 → 설정 편집(Edit Config) 으로 열리는 claude_desktop_config.json의 mcpServers에 추가하세요.

{
  "mcpServers": {
    "solidworks": {
      "command": "C:\\경로\\Solidworks-MCP\\.venv\\Scripts\\python.exe",
      "args": ["C:\\경로\\Solidworks-MCP\\solidworks_mcp_server.py"]
    }
  }
}

설정 파일 위치:

• 일반 설치: %APPDATA%\Claude\claude_desktop_config.json

• Microsoft Store/MSIX 설치: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

"command": "python" 대신 .venv 안의 python.exe 전체 경로를 쓰는 이유: PATH의 python이 Microsoft Store 별칭이거나 패키지가 없는 다른 버전일 수 있어서예요. 저장한 뒤에는 Claude를 트레이에서 완전히 종료하고 다시 실행하세요.

3) Claude Code

claude mcp add --scope user solidworks -- "C:\경로\Solidworks-MCP\.venv\Scripts\python.exe" "C:\경로\Solidworks-MCP\solidworks_mcp_server.py"
claude mcp list

사용 방법

1. SolidWorks를 먼저 열어 두세요. 꺼져 있으면 connect_solidworks가 직접 실행하고 최대 120초 기다려요.

2. Claude에게 평소 말투로 요청하세요. 길이는 따로 말하지 않으면 mm예요.

예시:

• "SolidWorks에 연결해줘"

• "새 파트를 만들고, 윗면에 반지름 30mm 원을 그려서 15mm 돌출해줘"

• "정면에 100×50mm 사각형을 그리고 20mm 돌출한 다음, 가운데에 지름 10mm 구멍을 관통 컷해줘"

• "피처 목록 보여줘" / "열린 문서 목록 보여줘" / "현재 문서 정보 알려줘"

• "C:\작업\bracket.SLDPRT로 저장해줘"

• "execute_python으로 현재 파트의 부피와 질량을 계산해줘"

Claude는 보통 create_sketch → draw_* → close_sketch → extrude_sketch 순서로 도구를 써요. 스케치가 열린 채로 남으면 get_sketch_status로 상태를 확인할 수 있어요.

Text-to-CAD 작업 흐름

짧거나 모호한 요청도 에이전트가 사양으로 정리하고, 모델을 직접 보고 재면서 빠르게 반복하게 하는 흐름이에요. 서버 instructions(solidworks_mcp/instructions.md)로 매 세션 자동 적용돼요(Cowork는 solidworks-design 스킬로).

1. 사양 정리: 목적, 기준 좌표계, 보호 인터페이스, 크기, 연결부, 하중·동작, 공정·재료를 충분히 구체화해요. 길이 제한은 없어요. 모든 수치에 근거를 붙여요. 순서는 [req] 요구 사항·기존 형상 > [std] 규격 > [calc] 계산 > [cat] 카탈로그·확인된 미스미 품번 > [dfm] 공정 규칙 > [heur] 경험칙 > [neutral] 근거가 없을 때의 중립값(대칭, 1:1, 같은 간격, R10 표준수, 정수 mm)이에요.

2. 필요한 지식만 조회: design_context(mode="quality")로 정책과 관련 근거를 읽어요. 기존 knowledge_search/knowledge_get도 사용할 수 있어요.

3. 단계별 모델링: 단계마다 execute_python 한 번, 파라미터는 스크립트 맨 위에 둬요.

4. 매 단계 검증: model_report(오류·바디·치수·질량). 형상·외형 판단에 충분한 render_views와 단면을 확보해요. 어셈블리는 check_interference.

5. 품질 게이트: 재생성 오류 없음, 의도한 바디 수, 사양 치수 일치, 의도치 않은 간섭 없음, 공정 규칙 충족. 통과해야 다음 단계로 넘어가요.

6. 짧은 보고: 핵심 치수와 근거, 검증 수치, 다음 선택지 최대 3개.

품질 우선: 치수·근거·가정·시각 증거를 유지하고 불필요한 반복만 줄여요. 제품 개선은 대안 3개, 정량·외형 평가, 검토 패킷과 사용자 검토를 거쳐요. 기존 노트의 표준 태그는 원문 확인을 대신하지 않아요. 자세한 내용은 knowledge/agent-guide.md, 근거 규칙은 knowledge/design-policy.md에 있어요.

도구 목록

길이 인자가 있는 도구는 모두 선택 인자 unit(mm, cm, m, inch, ft)을 받아요. 비우면 기본 단위(기본 mm)를 써요.

fillet_edges와 chamfer_edges는 모서리가 먼저 선택돼 있어야 해요. SolidWorks에서 직접 고르거나 execute_python으로 선택하세요.

execute_python 고급 사용

기본 도구로 안 되는 작업(로프트, 패턴, 어셈블리 메이트, 질량 특성, 이미지 저장 등)은 execute_python으로 SolidWorks API를 직접 쓸 수 있어요.

• 쓸 수 있는 변수: sw(SldWorks.Application), doc(활성 문서), automation(서버의 SolidWorksAutomation 객체), win32com, pythoncom, math, os, json

• 주입되는 도우미: val, call, arr, strings, byref_int, byref_bool, select(SelectByID2), plane("front"/"top"/"right")(한국어 평면 이름 자동), feats(), feat(이름), active(), report(), render(뷰), store(호출 사이에 유지되는 dict), mm(0.001), deg(π/180)

• print() 출력과 result 변수 값이 결과로 돌아와요. report: true로 부르면 실행 뒤 모델 요약이 붙고, render()는 이미지를 결과에 붙여요.

• 코드는 이 PC에서 그대로 실행되니까, 믿을 수 있는 요청에만 쓰세요.

SolidWorks 2025는 late binding으로 연결돼서 COM 호출에 주의할 점이 있어요.

1. 인자 없는 멤버는 접근하는 순간 실행돼요. GetTitle, GetType, FirstFeature, GetNextFeature, GetFirstDocument 같은 멤버 뒤에 ()를 붙이면 "구성원이 없습니다"(member not found)나 'int' object is not callable 오류가 나요.

2. 인자 있는 메서드가 엉뚱하게 실행되면 호출 전에 obj._FlagAsMethod("메서드이름")을 부르세요.

3. 숫자 배열 인자는 win32com.client.VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R8, 값목록)으로 넘기세요.

4. 한국어 SolidWorks에서는 기본 평면과 원점 이름이 정면, 윗면, 우측면, 원점이에요. 표준 뷰는 이름 대신 번호를 쓰세요. 예: doc.ShowNamedView2("", 7) (등각 보기).

P = dict(w=60.0, h=40.0, t=8.0)          # w, h [req]; t [neutral, R10]
sm = doc.SketchManager
select(doc, plane("top"), "PLANE")       # 한국어 UI에서도 "윗면"을 찾아요
call(sm, "InsertSketch", True)
call(sm, "CreateCenterRectangle", 0, 0, 0, P["w"] / 2 * mm, P["h"] / 2 * mm, 0)
call(sm, "InsertSketch", True)
result = report()                        # 오류, 바디, 경계 상자, 질량

설계 지식 베이스

에이전트가 knowledge/ 폴더의 Markdown 노트를 검색해서 써요. 토큰을 아끼려고 본문은 영어로 쓰고, 한글 키워드는 태그와 검색 사전으로 연결했어요.

노트를 추가하려면 같은 형식(맨 위 title, tags, summary와 ## 섹션)으로 knowledge/에 .md 파일을 넣고 Claude를 다시 시작하세요. 수치를 넣을 때는 출처(규격 번호, 카탈로그)를 함께 적어 주세요.

기어 생성기

gear_design(계산만)과 create_gear(SolidWorks 네이티브 피처)로 일반적인 기어를 만들어요. 기어 종류는 OpenSCAD 라이브러리 chrisspen/gears에 맞췄지만(헤링본 베벨과 체결 구멍 있는 랙은 제외, 유성기어는 gear_design으로 계산한 뒤 부품별로 생성), 그 라이브러리는 CC BY-NC-SA 3.0(비상업·동일조건)이라 코드는 쓰지 않고 규격(ISO 21771, ISO 53, Gleason/AGMA 2005, DIN 3975) 공식으로 직접 구현했어요. 사이클로이드와 하모닉 드라이브는 완제품 구매를 권해서 생성 대상에서 뺐어요.

• 기본값과 근거: 압력각 20°와 ISO 53 A [std], 백래시 0.04 m [heur], 치폭 10 m [heur], 작은 피니언은 언더컷 한계 전위 x_min과 V-zero 짝 [std], 링기어 림 d_f + 6 m [heur]. 결과에 근거 태그가 함께 나와요.

• 자가 검증: SolidWorks 부피를 정확한 치형 단면적 × 치폭과 비교(보통 0.1 % 이내), 바디 1개, 재생성 오류 없음, 헬리컬은 재질 탐침으로 나선 방향까지 확인해요.

• build_mate: true: 짝 기어(외접은 반대 방향, 내접은 같은 방향)도 만들고 한 피치 굴리면서 임시 바디로 간섭을 재요. 측정값: 스퍼·헬리컬·헤링본·내접·랙 0 mm³, 스파이럴 베벨 0.03–0.09 mm³(Tredgold 근사), 같은 방향 헬리컬 쌍은 162 mm³로 잘못된 조합을 잡아내요.

• 좌표계: 축 +Z, z = 0 면이 정면, 이홈 하나가 +X 중심. 짝 배치와 위상은 결과의 phase_deg를 쓰고, 자세한 내용은 지식 베이스 gear-generators에 있어요.

예: "모듈 1.5, 18:36 스퍼 기어 한 쌍, 보어 8에 키홈" → create_gear {"type": "spur", "module": 1.5, "teeth": 18, "mate_teeth": 36, "build_mate": true, "bore": 8, "keyway": true}

토폴로지 최적화

topology_optimize는 ToPy(MIT)를 Python 3 + scipy로 옮긴 SIMP 최적화예요. 최소 컴플라이언스(강성 최대), 컴플라이언트 메커니즘, 정상 열전도(대류는 막 계수로), 강성+열 복합을 2D 판재와 3D로 풀어요. 유동 CFD는 넣지 않았어요.

• 안전계수 2 규칙: 하중(loads, 체결부 force)과 열(power_W, heat_W)은 최대 사용값으로 넣고, 해석·미리보기·모든 검토는 그 2배(safety_factor, 2 미만은 오류)로 해요.

• 체결부(interfaces): 볼트(ISO 273 통과 구멍), 탭(ISO 2306 탭 드릴), 핀, 패드. 구멍은 비우고 반지름 max(1.5 d, 와셔 자리 + 요소 1개)의 링은 보존해요. 구멍 벽 절점이 지지·하중·열원·방열(기준 온도) 역할을 해요. 결과에 체결부별 볼트 전단·인장, 지압, 끝단 찢김, 탭 체결 길이(볼트 항복 전 나사산 파손 방지) 이용률이 나와요.

• 중요 형상(critical): 베어링 자리, 실링 면 등은 항상 남겨요.

• 검토: 설계 하중에서 응력 스크리닝(밀도 0.5 이상, 체결부 제외)이 항복 이하, 설계 열에서 최고 온도가 max_temperature_C 이하인지 봐요. 최종 CAD는 SOLIDWORKS Simulation으로 설계 하중에서 다시 확인해요.

• volume_fraction: "auto": 응력·온도 검토를 통과하는 가장 가벼운 부피율을 이분 탐색해요.

• 검증: 요소 강성 행렬이 ToPy의 SymPy 정의와 기계 정밀도로 같고, MBB 보 계산이 Sigmund 99줄 코드와 같은 값을 내요(첫 반복 1e-11, 8회 반복 1e-9).

• 문제는 mm로 정의해요: size, element_size, thickness, volume_fraction, supports, loads, keep_out/keep_in(볼트 구멍 주변은 보존, 움직이는 부품 자리는 제외), material. ToPy .tpd 파일도 그대로 받아요.

• 백그라운드 작업으로 돌고 이 호출은 최대 wait초 기다려요. 덜 끝났으면 job으로 다시 확인해요. 결과에는 반복 수, 부피율, 컴플라이언스, 하중점 변위(mm), 질량, 미리보기 이미지가 들어 있어요.

• build: true: 2D 결과는 밀도 0.5 등고선을 스플라인으로 그려 두께만큼 돌출해요(부피 오차 0.02 %). 3D 결과는 STL을 메시 솔리드 바디로 불러와요(다시 모델링할 때 참고용).

• 속도(측정): 2D 120 × 60 요소 약 4초, 3D 40 × 20 × 10 요소 반복당 약 0.7초.

예: 왼쪽 고정, 오른쪽 끝 중앙에 1000 N, 부피 40 %, 두께 6 mm 알루미늄 브래킷 → {"problem": {"size": [120, 60], "element_size": 1, "thickness": 6, "volume_fraction": 0.4, "supports": [{"edge": "left"}], "loads": [{"at": [120, 30], "force": [0, -1000]}], "material": {"E": 70000, "density": 2.7}}, "build": true}

설정 파일 config.json

solidworks_mcp/config.json을 고치면 코드를 건드리지 않고 동작을 바꿀 수 있어요. 바꾼 뒤에는 Claude를 다시 시작하세요.

문제 해결

Claude에 SolidWorks 도구가 안 보여요

1. Claude를 트레이 아이콘 → 종료(Quit)로 완전히 끄고 다시 실행하세요.

2. 설정 → 개발자에서 solidworks 상태를 확인하세요.

3. setup_mcp.log에서 could not update 같은 메시지가 있는지 보세요.

4. Claude를 끈 상태에서 설치를 한 번 더 실행해 보세요.

5. Claude의 MCP 로그를 보세요: %APPDATA%\Claude\logs\mcp-server-solidworks.log (MSIX 설치판은 %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\).

pip install -r requirements.txt가 실패해요: 이 저장소의 requirements.txt를 쓰고 있는지 확인하세요 (asyncio-compat 없음, mcp<2).

서버가 바로 꺼지고 로그에 'Server' object has no attribute 'list_tools'가 있어요: mcp 2.x가 설치된 거예요. .venv\Scripts\python.exe -m pip install "mcp>=1,<2"

"구성원이 없습니다"(Member not found) 오류: 위 execute_python 고급 사용의 COM 규칙을 보세요. 이 저장소의 기본 도구는 수정돼 있어요.

연결이 안 돼요: SolidWorks가 실행 중인지, 라이선스나 시작 대화상자가 떠 있지 않은지 확인하세요. get_solidworks_info로 설치가 탐지되는지 보고, 안 되면 config.json의 exe_path에 경로를 직접 넣으세요.

폴더를 옮겼어요: setup_windows.bat을 다시 실행하면 경로가 갱신돼요.

업데이트와 제거

• 업데이트: 설치할 때의 PowerShell 한 줄을 다시 실행하거나, 저장소에서 git pull 후 setup_windows.bat을 실행하세요 (새 패키지가 설치돼요).

• 제거: 명령 프롬프트에서 setup_windows.bat -Uninstall(또는 install.ps1 -Uninstall)을 실행하면 Claude Desktop·Claude Code 등록과 스킬을 지워요. 그다음 폴더를 삭제하세요. 설치 전 설정은 claude_desktop_config.json.bak-* 백업에 있어요. Claude 계정에 저장한 스킬은 Claude 설정에서 지우세요.

로드맵

SolidWorks 지원을 가장 먼저 해요. 진행 순서:

• Text-to-CAD 검증 루프: model_report, render_views, export_model, check_interference, execute_python 도우미

• 에이전트 가이드: 토큰 절약 규칙과 설계 근거 규칙 (서버 instructions)

• 설계 지식 베이스 1차: 설계 정책, 기어, 베어링, 체결, 공차, 축·키, 재료, DFM, API 레시피

• 부품 DB: KS/ISO 표준 부품 치수 표와, 사용자가 확인한 한국 미스미 품번 등록·검색 (미스미 사이트는 robots.txt와 약관이 자동 수집을 막아서 크롤링하지 않아요)

• 기어 생성기: 스퍼, 헬리컬, 헤링본, 내접, 랙, 직선·스파이럴 베벨, 웜·웜휠 (규격 공식, 부피·물림 자가 검증)

• 토폴로지 최적화: 2D/3D 강성·컴플라이언트 메커니즘 (ToPy 포팅), 2D 결과는 돌출 파트로

• 열·복합 위상 최적화: 열전도 + 대류 경계, 최대 하중·열의 2배 설계, 체결부 자동 처리와 검토, 자동 부피율

• 표준 검증과 워크플로: verify_model(V1 파트, V2 어셈블리), 어셈블리 가이드, 설계-모델링-검증 플라이휠

• 가공 최적화 모드: 2.5D 밀링·공구 반경·벽/바닥 두께 제약 (조사 완료, topology-optimization.md의 계획 참고)

• 유성기어 어셈블리 자동 배치와 3D 최적화 결과의 리모델링 보조

열전도(대류는 막 계수)는 자체 FE로 넣었어요. 유동 CFD(SOLIDWORKS Flow Simulation 연동)는 결과 신뢰성 문제로 계속 보류해요.

프로젝트 구조

Solidworks-MCP/
├── install.ps1                # 한 줄 설치 (irm ... | iex): 코드 받기, Python 찾기, setup_mcp.py 실행
├── setup_windows.bat          # 원클릭 설치 (더블클릭하면 install.ps1 실행)
├── setup_mcp.py               # 설치 로직: .venv, 패키지, 자가 진단, Claude Desktop·Claude Code 등록, 스킬
├── skills/solidworks-design/  # Claude 스킬: 설계 작업 규칙 (서버 instructions를 안 넘기는 Cowork 같은 클라이언트용)
├── solidworks_mcp_server.py   # MCP 서버 진입점
├── requirements.txt
├── knowledge/                 # 설계 지식 베이스 (Markdown 노트)
├── solidworks_mcp/
│   ├── server.py              # MCP 도구 정의와 처리
│   ├── instructions.md        # 매 세션 에이전트에게 주는 작업 규칙
│   ├── verification.py        # model_report, render_views, export_model, check_interference
│   ├── knowledge.py           # 지식 베이스 검색
│   ├── com.py                 # late binding COM 도우미 (val, call, arr, plane ...)
│   ├── gears/                 # 기어: geometry(인볼류트), bevel, build(SolidWorks), api(도구 인자)
│   ├── topopt/                # 토폴로지 최적화 (ToPy 포팅 + 열): problem, topology, physics(열·응력·체결부), export, run, cad
│   ├── tests/                 # 기어·최적화·설치 단위 테스트 (python -m unittest solidworks_mcp.tests.test_gears ...)
│   ├── config.py, config.json # 설정
│   ├── constants.py           # SolidWorks 상수
│   ├── automation/            # base(연결), documents, sketches, features
│   └── utils/                 # 단위 변환, SolidWorks 설치 탐지
├── scripts/                   # 원본 프로젝트의 VBS 예제
├── solidworks_com.py, solidworks_simulation.py   # 원본 프로젝트의 이전 버전 스크립트
└── DEVELOPMENT_ROADMAP.md     # 원본 프로젝트의 개발 계획

라이선스와 크레딧

MIT 라이선스예요 (LICENSE). 원본 프로젝트: alisamsam/Solidworks-MCP, Samsaam Ali Baig. 원본 저작권 표시와 라이선스 문구를 유지해 주세요.

토폴로지 최적화 코드(solidworks_mcp/topopt/)는 William Hunter의 ToPy(MIT)를 옮긴 것이고, 라이선스 전문은 solidworks_mcp/topopt/LICENSE_TOPY.md에 있어요. ToPy의 2D 부분은 Ole Sigmund의 99줄 코드를 바탕으로 해요. 기어 생성기는 chrisspen/gears(CC BY-NC-SA 3.0)의 코드를 쓰지 않았어요.

English

Contents

1. Overview

2. Changes from the original

3. Requirements

4. Quick start

5. What the installer does

6. Manual setup

7. Usage

8. Text-to-CAD workflow

9. Tool reference

10. Advanced: execute_python

11. Design knowledge base

12. Gear generators

13. Topology optimization

14. Configuration (config.json)

15. Troubleshooting

16. Updating and uninstalling

17. Roadmap

18. Project structure

19. License and credits

Overview

SolidWorks MCP Server is a Model Context Protocol server that lets an AI agent such as Claude drive SolidWorks. Instead of clicking through menus, you describe the geometry you want and Claude builds it through the SolidWorks COM API: parts, sketches and features.

• 52 tools (35 CAD and verification + 17 Design Studio): connection, documents, sketches, features, utilities, execute_python for direct SolidWorks API access, verification (text-to-CAD), design-knowledge search, gear generation and topology optimization

• Agent working rules (token budget, design rationale) are applied automatically in every session

• SolidWorks 2023–2025, installation auto-detected from the registry

• Units: mm, cm, m, inch, ft (default mm)

• Activity log: solidworks_mcp/solidworks_mcp.log

Changes from the original

Requirements

• Windows 10 / 11 (64-bit)

• SolidWorks 2023–2025, installed and licensed

• Python 3.10 or newer (64-bit): the python.org installer or the Python Install Manager (py). Without one, the installer can install Python 3.13 with winget

• Claude Desktop or Claude Code

• Internet access for the first install (pip packages, about 60 MB including numpy and scipy for topology optimization)

Tested with SolidWorks 2025 (revision 33.5.0, Korean UI), Python 3.14.7 and Claude Desktop for Windows (Microsoft Store/MSIX build).

Quick start

The easiest way is to ask Claude to install it, as shown at the top. To do it yourself:

1. Run the installer: paste this line into PowerShell.

   irm https://raw.githubusercontent.com/hayward2007/solidworks-mcp/main/install.ps1 | iex

   The code goes to %USERPROFILE%\solidworks-mcp. If you downloaded the repository yourself (git clone https://github.com/hayward2007/solidworks-mcp.git or a ZIP), you can double-click setup_windows.bat in it instead. You are done when it prints All set. The folder path is written into Claude's config, so run it again if you move the folder later.

2. Quit Claude Desktop completely and start it again: right-click the Claude icon in the system tray (bottom-right, possibly under the ^ arrow), choose Quit, then start Claude again. Closing the window leaves it running in the background, and it will not read the new config. In Claude Code, start a new session.

3. Open SolidWorks and ask Claude: "Connect to SolidWorks".

In Claude, Settings → Developer should show the solidworks server as running.

Using Cowork? Save the design skill too. Cowork does not pass the server instructions (working rules) to the model; the solidworks-design skill brings them in. In Cowork, ask Claude to "save the solidworks-design skill from https://github.com/hayward2007/solidworks-mcp" and save the card it shows. On claude.ai you can upload the dist\solidworks-design.zip the installer writes under Settings → Capabilities → Skills. For Claude Code the installer puts the skill into ~/.claude/skills.

What the installer does

1. Gets the code: git clone into %USERPROFILE%\solidworks-mcp (the GitHub ZIP when git is missing), or updates an existing copy. Started from setup_windows.bat inside a copy of the repository, it uses that folder as it is.

2. Finds a 64-bit Python 3.10+: the py -0p list, py -3, python on PATH, then %LOCALAPPDATA%\Python\pythoncore-3.*, %LOCALAPPDATA%\Programs\Python\Python3* and %ProgramFiles%\Python3*. It picks the newest of 3.10–3.14, which numpy, scipy and pywin32 ship wheels for. Without one it offers to install Python 3.13 with winget (-InstallPython installs it without asking).

3. Creates a virtual environment in .venv inside the project folder (reuses a working one).

4. Installs requirements.txt (mcp 1.x, pywin32, python-dotenv, Pillow, numpy, scipy).

5. Self-test: starts the server over stdio, exactly like Claude Desktop does, and checks the MCP handshake and the tool list (52 tools).

6. Registers the solidworks server in Claude Desktop's config. Other servers and settings are kept, and a claude_desktop_config.json.bak-date-time backup is written before any change. The Microsoft Store (MSIX) config location is updated too.

7. If Claude Code (the claude CLI) is installed, registers the server with claude mcp add --scope user and copies the design skill to ~/.claude/skills/solidworks-design. It also writes dist\solidworks-design.zip for uploading the skill to Claude Desktop / claude.ai.

8. Saves everything it printed to setup_mcp.log.

It is safe to run again; an existing registration shows already up to date. Options: -InstallDir <path>, -InstallPython, -NoClaudeDesktop, -NoClaudeCode, -NoSkill, -Uninstall; setup_windows.bat passes them on (e.g. setup_windows.bat -Uninstall).

Manual setup

1) Install the packages

cd C:\path\to\Solidworks-MCP
py -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements.txt

2) Claude Desktop

Open Claude → Settings → Developer → Edit Config and add this under mcpServers in claude_desktop_config.json:

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

Config file locations:

• Standard install: %APPDATA%\Claude\claude_desktop_config.json

• Microsoft Store/MSIX install: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\claude_desktop_config.json

Use the full path to the .venv interpreter rather than "command": "python": python on PATH may be the Microsoft Store alias or a different Python without the packages. After saving, quit Claude from the tray and start it again.

3) Claude Code

claude mcp add --scope user solidworks -- "C:\path\to\Solidworks-MCP\.venv\Scripts\python.exe" "C:\path\to\Solidworks-MCP\solidworks_mcp_server.py"
claude mcp list

Usage

1. Open SolidWorks first. If it is not running, connect_solidworks starts it and waits up to 120 seconds.

2. Ask Claude in plain language. Lengths are in mm unless you say otherwise.

Examples:

• "Connect to SolidWorks"

• "Create a new part, draw a 30 mm radius circle on the Top plane and extrude it 15 mm"

• "Draw a 100 × 50 mm rectangle on the Front plane, extrude it 20 mm, then cut a 10 mm hole through the center"

• "List the features" / "List open documents" / "Show the active document info"

• "Save it as C:\work\bracket.SLDPRT"

• "Use execute_python to compute the volume and mass of this part"

Claude typically chains create_sketch → draw_* → close_sketch → extrude_sketch. If a sketch is left open, get_sketch_status shows its state.

Text-to-CAD workflow

A loop that lets the agent turn short or vague requests into a spec, then build, look and measure, and iterate quickly. It is sent to the agent in every session as the server instructions (solidworks_mcp/instructions.md); in Cowork the solidworks-design skill brings it in.

1. Spec: purpose, datums, protected interfaces, envelope, loads/motion, process and material in sufficient detail; no length cap. Every number gets a basis, in this order: [req] requirement or existing geometry > [std] standard > [calc] calculation > [cat] catalogue or user-verified MISUMI part > [dfm] process rule > [heur] rule of thumb > [neutral] a neutral value when nothing else applies (symmetry, 1:1, equal spacing, R10 preferred numbers, whole mm).

2. Retrieve justified context: design_context(mode="quality"); legacy search/get remain available.

3. Build in stages: one execute_python call per stage, parameters at the top of the script.

4. Verify every stage: model_report (errors, bodies, box, mass), sufficient orthographic/section/material render_views, check_interference for assemblies.

5. Quality gate: no rebuild errors, intended body count, dimensions match the spec, no unintended interference, process rules met, before moving on.

6. Short report: key dimensions with their basis, check numbers, at most 3 next options.

Quality before compression: retain numerical and visual evidence, sources and assumptions. Product improvement includes three alternatives, quantitative and aesthetic assessment, a review export and explicit user review. A legacy standard tag is not source verification. Details: knowledge/agent-guide.md; rationale rules: knowledge/design-policy.md.

Tool reference

Every tool that takes lengths also accepts an optional unit (mm, cm, m, inch, ft); when omitted, the default unit (mm) is used.

fillet_edges and chamfer_edges work on edges that are already selected; select them in SolidWorks or with execute_python.

Advanced: execute_python

For anything the basic tools do not cover (lofts, patterns, assembly mates, mass properties, image export, ...) use execute_python to call the SolidWorks API directly.

• Available names: sw (SldWorks.Application), doc (active document), automation (the server's SolidWorksAutomation object), win32com, pythoncom, math, os, json

• Injected helpers: val, call, arr, strings, byref_int, byref_bool, select (SelectByID2), plane("front"/"top"/"right") (localized plane names), feats(), feat(name), active(), report(), render(views), store (a dict kept between calls), mm (0.001), deg (π/180)

• Whatever you print() and the value of result are returned. With report: true the model report is appended; render() attaches an image.

• The code runs as-is on this PC, so only use it with requests you trust.

SolidWorks 2025 is reached through late binding, which has a few COM pitfalls:

1. Zero-argument members run as soon as you access them. Adding () after members such as GetTitle, GetType, FirstFeature, GetNextFeature or GetFirstDocument raises "Member not found" or 'int' object is not callable.

2. If a method that takes arguments misbehaves, call obj._FlagAsMethod("MethodName") before calling it.

3. Pass numeric arrays as win32com.client.VARIANT(pythoncom.VT_ARRAY | pythoncom.VT_R8, values).

4. Localized SolidWorks uses localized names for the default planes and origin (Korean: 정면, 윗면, 우측면, 원점). Use view IDs instead of view names, for example doc.ShowNamedView2("", 7) for isometric.

P = dict(w=60.0, h=40.0, t=8.0)          # w, h [req]; t [neutral, R10]
sm = doc.SketchManager
select(doc, plane("top"), "PLANE")       # also finds the localized Top plane
call(sm, "InsertSketch", True)
call(sm, "CreateCenterRectangle", 0, 0, 0, P["w"] / 2 * mm, P["h"] / 2 * mm, 0)
call(sm, "InsertSketch", True)
result = report()                        # errors, bodies, box, mass

Design knowledge base

The agent searches the Markdown notes in knowledge/. Notes are written in English to save tokens; Korean keywords are linked through tags and a search dictionary.

To add a note, put a .md file in knowledge/ with the same layout (title, tags, summary at the top, ## sections) and restart Claude. Give a source (standard number, catalogue) for every value.

Gear generators

gear_design (numbers only) and create_gear (native SolidWorks features) cover the common gear types. The type list follows the OpenSCAD library chrisspen/gears (except herringbone bevels and racks with screw holes; planetary sets are computed with gear_design and built part by part), but that library is CC BY-NC-SA 3.0 (non-commercial, share-alike), so none of its code is used: everything is implemented from the standards (ISO 21771, ISO 53, Gleason/AGMA 2005, DIN 3975). Cycloidal and strain-wave drives are left out (buy them as units).

• Defaults and basis: 20 deg and ISO 53 A [std], backlash 0.04 m [heur], face width 10 m [heur], small pinions get the undercut limit x_min with a V-zero mate [std], ring rim d_f + 6 m [heur]. Results carry the basis tags.

• Self-checks: SolidWorks volume against the exact tooth-section area x face width (normally within 0.1 %), one body, no rebuild errors, helix hand confirmed by probing the material.

• build_mate: true builds the mating gear (opposite hand external, same hand internal) and rolls the pair through one pitch with temporary bodies. Measured: spur, helical, herringbone, internal and rack pairs 0 mm³; spiral bevel 0.03-0.09 mm³ (Tredgold approximation); a same-hand helical pair shows 162 mm³, so wrong combinations are caught.

• Frames: axis +Z, z = 0 face on the Front plane, a tooth space centred on +X. Use phase_deg from the result to place pairs; details in the knowledge note gear-generators.

Example: "module 1.5, 18:36 spur pair, 8 mm bore with keyway" -> create_gear {"type": "spur", "module": 1.5, "teeth": 18, "mate_teeth": 36, "build_mate": true, "bore": 8, "keyway": true}

Topology optimization

topology_optimize is a SIMP optimizer ported from ToPy (MIT) to Python 3 + scipy: minimum compliance (maximum stiffness), compliant mechanisms, steady heat conduction (convection as film coefficients) and stiffness plus heat together, 2D plates and 3D. Fluid CFD is not included.

• Safety factor 2: loads (loads, joint force) and heat (power_W, heat_W) are maximum service values; analysis, preview and every check use 2 x (safety_factor, below 2 is an error).

• Joints (interfaces): bolt (ISO 273 clearance), tapped hole (ISO 2306 tap drill), pin and pad. The hole is void, a ring of radius max(1.5 d, washer seat + one element) stays solid, and the hole-wall nodes act as support, load, heat source or sink. Results list per-joint utilisation: bolt shear and tension, bearing, tear-out, tapped-hole engagement (thread must not strip before the bolt yields).

• Critical features (critical) such as bearing seats and sealing faces always stay solid.

• Checks: stress screening (density >= 0.5, joints excluded) at the design load against yield, and peak temperature at the design heat against max_temperature_C. Verify the final CAD in SOLIDWORKS Simulation at the design loads.

• volume_fraction: "auto" bisects for the lightest volume fraction that passes the stress and temperature checks.

• Verification: the element matrices equal ToPy's SymPy definitions to machine precision, and the MBB beam reproduces Sigmund's 99-line code (first iteration to 1e-11, eight iterations to 1e-9).

• Problems are given in mm: size, element_size, thickness, volume_fraction, supports, loads, keep_out / keep_in (keep material around bolt holes, clear space for moving parts), material. ToPy .tpd files are accepted as they are.

• Runs as a background job; the call waits up to wait s, then poll with job. Results include iterations, volume fraction, compliance, load-point displacement (mm), mass and a preview image.

• build: true: a 2D result becomes splines along the 0.5-density contour extruded by the thickness (volume error 0.02 %); a 3D result is imported from STL as a mesh solid body (reference for remodelling).

• Speed (measured): 2D 120 x 60 elements about 4 s; 3D 40 x 20 x 10 elements about 0.7 s per iteration.

Example: left edge fixed, 1000 N at the middle of the right end, 40 % volume, 6 mm aluminium bracket -> {"problem": {"size": [120, 60], "element_size": 1, "thickness": 6, "volume_fraction": 0.4, "supports": [{"edge": "left"}], "loads": [{"at": [120, 30], "force": [0, -1000]}], "material": {"E": 70000, "density": 2.7}}, "build": true}

Configuration (config.json)

Edit solidworks_mcp/config.json to change behavior without touching code, then restart Claude.

Troubleshooting

The SolidWorks tools don't show up in Claude

1. Quit Claude from the tray icon (Quit) and start it again.

2. Check the solidworks server under Settings → Developer.

3. Look for could not update messages in setup_mcp.log.

4. Run the installer once more while Claude is closed.

5. Read Claude's MCP log: %APPDATA%\Claude\logs\mcp-server-solidworks.log (MSIX build: %LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\logs\).

pip install -r requirements.txt fails: make sure you are using this repository's requirements.txt (no asyncio-compat, mcp<2).

The server exits immediately and the log shows 'Server' object has no attribute 'list_tools': mcp 2.x got installed. Run .venv\Scripts\python.exe -m pip install "mcp>=1,<2".

"Member not found" errors: see the COM rules in Advanced: execute_python. The built-in tools in this repository are already fixed.

It can't connect: check that SolidWorks is running and that no license or startup dialog is open. Run get_solidworks_info to see whether the installation is detected; if not, set exe_path in config.json.

You moved the folder: run setup_windows.bat again to update the paths.

Updating and uninstalling

• Update: run the PowerShell line again, or git pull in your copy and run setup_windows.bat (installs new packages).

• Uninstall: run setup_windows.bat -Uninstall (or install.ps1 -Uninstall) in a command prompt; it removes the Claude Desktop and Claude Code registrations and the skill. Then delete the folder. Your pre-install config is in the claude_desktop_config.json.bak-* backup. A skill saved in your Claude account is removed in Claude's settings.

Roadmap

SolidWorks support comes first. Order of work:

• Text-to-CAD verification loop: model_report, render_views, export_model, check_interference, execute_python helpers

• Agent guide: token rules and design-rationale rules (server instructions)

• Design knowledge base v1: design policy, gears, bearings, fasteners, fits, shafts and keys, materials, DFM, API recipes

• Parts database: KS/ISO standard part tables plus MISUMI Korea part numbers registered by the user (the MISUMI site's robots.txt and terms forbid automated collection, so it is not crawled)

• Gear generators: spur, helical, herringbone, internal, rack, straight and spiral bevel, worm and worm wheel (standard formulas, self-checked volume and mesh)

• Topology optimization: 2D/3D stiffness and compliant mechanisms (ToPy port), 2D results as extruded parts

• Thermal and combined topology optimization: heat conduction with convection films, design at 2 x maximum force and heat, automatic joint handling and checks, automatic volume fraction

• Standard verification and workflow: verify_model (V1 part, V2 assembly), assembly guide, design-model-verify flywheel

• Machining optimization mode: 2.5D milling, tool radius, wall and floor thickness constraints (survey done; plan in topology-optimization.md)

• Planetary assembly placement and help with remodelling 3D optimization results

Heat conduction (convection as film coefficients) is now built in with its own FE. Fluid CFD (SOLIDWORKS Flow Simulation) stays out of scope because its results were not trusted enough.

Project structure

Solidworks-MCP/
├── install.ps1                # one-line installer (irm ... | iex): gets the code, finds Python, runs setup_mcp.py
├── setup_windows.bat          # one-click installer (double-click; runs install.ps1)
├── setup_mcp.py               # installer logic: .venv, packages, self-test, Claude Desktop and Claude Code registration, skill
├── skills/solidworks-design/  # Claude skill: design working rules (for clients such as Cowork that do not pass server instructions on)
├── solidworks_mcp_server.py   # MCP server entry point
├── requirements.txt
├── knowledge/                 # design knowledge base (Markdown notes)
├── solidworks_mcp/
│   ├── server.py              # MCP tool definitions and handlers
│   ├── instructions.md        # working rules sent to the agent in every session
│   ├── verification.py        # model_report, render_views, export_model, check_interference
│   ├── knowledge.py           # knowledge base search
│   ├── com.py                 # late-binding COM helpers (val, call, arr, plane, ...)
│   ├── gears/                 # gears: geometry (involute), bevel, build (SolidWorks), api (tool arguments)
│   ├── topopt/                # topology optimization (ToPy port + heat): problem, topology, physics (heat, stress, joints), export, run, cad
│   ├── tests/                 # gear, optimizer and installer unit tests (python -m unittest solidworks_mcp.tests.test_gears ...)
│   ├── config.py, config.json # configuration
│   ├── constants.py           # SolidWorks constants
│   ├── automation/            # base (connection), documents, sketches, features
│   └── utils/                 # unit conversion, SolidWorks detection
├── scripts/                   # VBS examples from the original project
├── solidworks_com.py, solidworks_simulation.py   # earlier scripts from the original project
└── DEVELOPMENT_ROADMAP.md     # the original project's development plan

License and credits

MIT License (LICENSE). Original project: alisamsam/Solidworks-MCP by Samsaam Ali Baig. Please keep the original copyright notice and license text.

The topology optimization code (solidworks_mcp/topopt/) is a port of ToPy by William Hunter (MIT); the full license is in solidworks_mcp/topopt/LICENSE_TOPY.md. ToPy's 2D part is based on Ole Sigmund's 99-line code. The gear generators do not use code from chrisspen/gears (CC BY-NC-SA 3.0).