109개의 도구를 갖춘 SolidWorks 자동화용 Python MCP 서버이며, AI 지원 워크플로우를 위한 선택적인 에이전트/프롬프트 테스트 (prompt-testing) 레이어를 포함합니다.

⚠️ 프로젝트 상태: 이 프로젝트는 현재 활발히 구축 중입니다. Python 및 UI 구현이 완료됨에 따라 기능, API, 문서 및 설정 단계가 변경될 수 있습니다. 이는 취미/연구용 제품이므로, 질문이나 피드백이 있다면 자유롭게 이슈(issue)를 생성해 주세요! ⚠️

이 프로젝트는 AI 친화적인 루프를 통한 실용적인 SolidWorks 자동화에 중점을 둡:

• 의도 기술 (describe intent)
• 계획 생성 (generate a plan)
• MCP 도구 실행 (execute MCP tools)
• 결과 검사 (inspect results)
• 반복 (iterate)

포함 사항:

• SolidWorks 도구 실행을 위한 핵심 MCP 런타임 (runtime)

• COM/VBA 라우팅 및 어댑터 안전 래퍼 (safety wrappers)

• 모델링 (modeling), 스케치 (sketching), 도면 (drawing), 분석 (analysis), 내보내기 (export), 자동화 (automation), 템플릿 (templates) 및 매크로 (macros) 전반에 걸친 도구 범위

• src/solidworks_mcp/agents/ 아래의 선택적인 에이전트 오케스트레이션/테스트 유틸리티

• 주요 CAD 라이프사이클을 위한 Windows + SolidWorks COM 자동화.

• 모델링, 스케치, 도면, 분석, 내보내기, 자동화, 템플릿 및 매크로 도구.

• 활성 뷰포트(viewport)로부터 PNG 형식의 프리팹 UI 미리보기 동기화.

• 모의(Mock) 어댑터 출력은 시뮬레이션된 것이며 공학적 사실로 간주해서는 안 됩니다.

• UI 내 실시간 3D 뷰포트 스트리밍.

• UI 러너(runner) 내 체크포인트 수준의 간섭 검증.

다음은 엔드 투 엔드(end-to-end)로 검증된 설정 경로입니다:

• python.org에서 Python 설치 (Windows 설치 프로그램).
• 설치 중에 python.exe를 PATH에 추가 (Add python.exe to PATH) 활성화.
• 이 프로젝트를 로컬 .venv에 설치.
• .venv\Scripts\python.exe에서 MCP 실행 (WSL에서 실행하지 마세요).

설정이 올바르면 시작 로그에 다음과 같이 표시됩니다:

Platform: Windows

SolidWorks COM interface is available

Registered ... SolidWorks tools

(도구의 발전에 따라 개수는 변동됨)
Connected to SolidWorks

• 실제 SolidWorks COM 자동화를 위한 Windows 10/11.
• python.org의 Python 3.11+.
• Git.
• 설치되어 있고 최소 한 번 실행된 SolidWorks.

Linux/WSL은 문서/테스트/모의(mock) 모드에는 유용하지만, 직접적인 COM 자동화에는 적합하지 않습니다.

git clone https://github.com/andrewbartels1/SolidworksMCP-python.git
cd SolidworksMCP-python
python -m venv .venv
...

서버 수동 시작:

.\.venv\Scripts\python.exe -m solidworks_mcp.server

또는 헬퍼 스크립트 사용 (먼저 SolidWorks를 실행하세요):

powershell -NoProfile -ExecutionPolicy Bypass -File .\run-mcp.ps1 --real --year 2026

모의(Mock) 모드 경고 — --real 옵션 없이 run-mcp.ps1을 실행하면 서버가 모의(Mock) 모드로 시작됩니다. 모든 도구 응답은 시뮬레이션되며, SolidWorks에 아무런 영향을 주지 않습니다. 실제 자동화를 위해서는 항상 --real --year <year>를 전달하세요.

일반적인 워크플로우에는 헬퍼 스크립트를 사용하세요:

.\dev-commands.ps1

주요 명령어:

dev-install

• 로컬 개발 환경 설치/업데이트

dev-test

• 표준 테스트 스위트 실행 (CI-safe 서브셋)

dev-test-full

• 전체 테스트 스위트 실행 (스모크/통합 경로 포함)

dev-lint

• 린트(Lint) 체크

dev-format

• 코드 포맷팅

dev-docs-build

• 문서 사이트 1회 빌드

dev-docs-strict

• 엄격한 문서 빌드 (경고 발생 시 실패)

dev-docs-audit

• .generated/docs에 문서 감사(Audit) 보고서 생성

GitHub Actions CI를 로컬에서 미러링하려면 (solidworks_mcp.yml의 Ubuntu + conda 환경 + make test 사용), 다음을 실행하세요:

.\run-ci-local.ps1

첫 실행 시에는 이미지를 빌드합니다. 테스트만 실행할 때는 재빌드 없이 다시 실행하세요:

.\run-ci-local.ps1 -NoBuild

사용자 MCP 설정(%APPDATA%\Code\User\mcp.json)을 다음과 같이 설정하세요:

{
"servers": {
"solidworks-mcp-server": {
...

스크립트 경로를 로컬 저장소 경로로 교체하세요. --real --year 2026 플래그는 서버를 실제 COM 자동화 모드로 시작합니다 (SolidWorks가 열려 있어야 함). 모의(Mock) 모드로 사용하려면 이 플래그를 생략하세요.

LM Studio MCP 설정 파일에 이 서버를 포함하도록 설정하세요 (LM Studio는 mcpServers 형식을 기대합니다):

{
"mcpServers": {
"solidworks-mcp-server": {
...

대안적인 직접 Python 엔트리:

{
"mcpServers": {
"solidworks-mcp-server": {
...

저장 후, MCP 서버를 다시 로드하도록 LM Studio를 재시작하세요.

python을 찾을 수 없는 경우:

python --version

만약 Microsoft Store가 열리거나 실행에 실패한다면, python.org에서 Python을 다시 설치하고 PATH를 활성화하세요.

ModuleNotFoundError: solidworks_mcp 오류와 함께 시작에 실패하는 경우:

.\.venv\Scripts\python.exe -m pip install -e .

ModuleNotFoundError: fastmcp 오류와 함께 시작에 실패하는 경우:

.\.venv\Scripts\python.exe -m pip install -e .

• 메인 문서 사이트: https://andrewbartels1.github.io/SolidworksMCP-python/
• 홈/개요: docs/index.md

주요 문서 섹션:

• 시작하기 (Getting Started): docs/getting-started
• MCP 서버 가이드 (MCP Server Guide): docs/user-guide
• 도구 카탈로그 (Tool Catalog): docs/user-guide/tool-catalog
• 에이전트 및 스킬 (Agents and Skills): docs/agents
• 계획/로드맵 (Planning/Roadmap): docs/planning

직접 링크:

• 설치 (Installation)
• 빠른 시작 (Quick Start)
• 튜토리얼: U-Joint 조립 빌드 (Tutorial: U-Joint Assembly Build)
• 튜토리얼 트랙 (Tutorial Tracks)
• 프리팹 UI 대시보드 (Prefab UI Dashboard)
• VS Code MCP 설정 (VS Code MCP Setup)
• 아키텍처 (Architecture)
• 에이전트 및 프롬프트 테스트 (Agents and Prompt Testing)
• PydanticAI 및 스키마 (PydanticAI and Schemas)

MIT 라이선스. LICENSE를 참조하세요.