PS3D CAD Studio

PS3D CAD Studio는 독립적이고 독창적인 로컬 우선(local-first) 브라우저 CAD 연구 프로젝트입니다. 현재 저장소는 작업 중인 0.2 공개 릴리스 후보입니다. Sketch, Part, Assembly, Surface, Drawing, Electrical, Vehicle, Automate 워크스페이스 전반에 걸친 하나의 의미론적 프로젝트와 Learning Center, 보안 계정 포털, 인증된 원격 MCP 전송을 포함합니다.

PartMode나 다른 CAD 코드베이스에서 복사한 것이 아닙니다. 이 프로젝트는 자체 요구사항, 아키텍처, 소스, 인터페이스, 예제, 테스트, 출처 기록, MIT 라이선스를 보유합니다. 독립적인 개발은 저작권 위험을 줄여주지만 법적 의견이나 특허, 상표, 자유 실시(freedom-to-operate) 보증은 아닙니다.

공식 공개 소스: sagar25-Code-it/ps3d-cad-studio.

로컬에서 동작하는 기능

공개 계정 포털은 이메일 인증 가입, 로그인, 로그아웃, 비밀번호 복구, 탭 범위 세션, 사용자당 최대 5개의 고유 만료 MCP 개인 토큰을 지원합니다. OAuth 2.1은 호환 AI 호스트를 위한 선호 연결 경로입니다. 원시 개인 토큰은 한 번만 표시되며 페퍼링된 HMAC 다이제스트로만 영구 저장됩니다. Learning Center는 초급부터 고급 실습까지 12개의 검증 주도 모듈을 포함하며 동일한 검토 소스 콘텐츠에서 15페이지 PDF 매뉴얼을 생성합니다.

셸은 또한 원본 컬러 휠 워크스페이스 시스템, 기능적인 File/Edit/Create/View/Inspect/Automate/Help 메뉴 모음, 프로젝트 소유 인라인 SVG 기호가 있는 상황 인식 상단 명령 리본, 키보드 탐색 및 워크스페이스 필터링된 119개 명령 원본 CAD 카탈로그(명시적 기능 수준 포함), Origin/Sketches/Feature History/Bodies/개정 타임라인이 있는 영구 모델 브라우저, 워크스페이스 보존 선택, 개정 감사, 브라우저 로컬 IndexedDB 저장/로드, 광범위한 프로젝트 JSON, 검증된 부품의 네이티브 개정 JSON 및 바이너리 STL, 안전한 드로잉 SVG, 정직한 기능 배지, 표시 가능한 진단을 제공합니다. 연구된 상호작용 기준 및 구현 매트릭스는 docs/product/CAD_INTERACTION_ESSENTIALS.md에 있습니다. 팔레트, 명령 기호, 메뉴 및 반응형 규칙은 docs/product/UI_COLOR_AND_COMMAND_SYSTEM.md에 기록되어 있습니다. 정확한 교환 형식 매트릭스, 단위 규칙, PDF 경계 및 보안 모델은 docs/product/3D_EXCHANGE_AND_PDF.md에 있습니다. 자동 뷰, 치수, 일반 공차, 데이텀 및 GD&T 검토 경계는 docs/product/AUTOMATIC_DRAWING_AND_TOLERANCE.md에 있습니다. 공칭 컨테이너 템플릿, 비인증 BESS 배치 경계, 전기 데이터 모델, 회로 템플릿, ERC 및 엔지니어링 제외 사항은 docs/product/CONTAINER_BESS_AND_ELECTRICAL.md에 있습니다. 범용 전기 패널 카탈로그, ECAD↔MCAD 트레이스 모델, 도체 경로 경계, 오래된 링크 동작 및 MCP 확인 계약은 docs/product/ELECTROMECHANICAL_REALIZATION.md에 있습니다. 차량 템플릿, SI 규칙, 표시 방정식, 삼륜 지지 모델, MCP 경계, 자격 제외 사항 및 연구 소스 색인은 docs/product/VEHICLE_ENGINEERING.md에 있습니다. 31개 역할의 PS Code Hub 페르소나 명단, 6개의 확장 PS3D 전문가 역할, 정직한 자격 경계, 작업 라우팅 모델 및 검토 루프는 docs/PS_CODE_HUB_AI_TEAM.md에 있습니다. 결정적 워크스페이스 건강 매트릭스, 실제 연관성 맵, 재구축 검토 순서, 수리 대기열, 점수 규칙 및 릴리스 경계는 docs/product/DESIGN_HEALTH_AND_REBUILD.md에 있습니다.

중심 보어 부품 경로만 qualified로 표시됩니다. 다른 모든 기능 워크벤치 기능은 preview로 표시됩니다. 정확한 B-rep/NURBS, 일반 부울 및 구속 솔버, 영구 면 이름 지정, 트리밍/시밍, STEP/IGES/DWG/DXF 정확한 변환, 네이티브 독점 CAD, 생산 도면 PDF 인증, 공유 클라우드 CAD 문서 협업, 자동 전기 사이징, 보호 협조, 아크 플래시/규정 준수 분석, 제조업체 정확한 자동 전기 패키지, 도체/하네스 사이징, 검증된 차량 다물체/타이어/FEA/열/충돌 시뮬레이션, 형식 승인 및 라이브 브라우저 MCP 제어는 사용할 수 없습니다. 원격 인증 MCP는 상태 비저장 미리보기 전송입니다. 명시적 경계 값을 수락하고 JSON 또는 새 프로젝트 사본을 반환합니다. 열린 CAD 탭을 제어하지 않습니다. 정확한 계약 및 제외 사항은 docs/product/PRD_PHASE_1_WORKBENCH_PREVIEW.md를 참조하십시오.

Related MCP server: solidworks-mcp

실행 및 검증

전제 조건은 Node.js 24 이상과 pnpm 11.9.0입니다. 모든 패키지 버전은 정확하며 잠금-인벤토리 조정은 실행되는 테스트/빌드 게이트입니다.

pnpm install --frozen-lockfile --ignore-scripts
pnpm peers check
pnpm typecheck
pnpm test
pnpm build
pnpm dev

Vite는 로컬 브라우저 URL을 출력합니다. pnpm test는 타입 패키지 스위트, 실제 MCP stdio 클라이언트/서버 교환, 종속성 조정 및 두 소스 정체성 게이트를 실행합니다. pnpm build는 추가로 Node 전용 MCP SDK, Manifold 후보, WASM 및 브라우저 그래프의 동적 평가를 거부하고 정적 호스트 보안 정책 및 번들 공지를 검증합니다. 포함된 GitHub 워크플로는 정리된 호스트 러너에서 타입 검사, 증거, 빌드, CodeQL 및 종속성 검토 게이트를 반복합니다.

MCP 호스트 연결

배포된 인스턴스의 경우 /access에 표시된 HTTPS 엔드포인트를 사용하십시오:

https://your-ps3d-domain.example/api/mcp

자동 OAuth 2.1 검색을 선호하십시오. 호스트가 OAuth가 아닌 사용자 지정 HTTP 헤더를 지원하는 경우 /access에서 범위가 지정되고 만료되는 ps3d_mcp_... 개인 토큰 하나를 만드십시오. 웹 비밀번호를 MCP 구성에 넣지 마십시오. 전체 원격 구성, 범위, 오류 및 안전 명령 가이드는 docs/MCP_CONNECTION_GUIDE.md에 있습니다.

로컬 stdio 서버는 승인된 로컬 호스트에서 계속 사용할 수 있습니다. 상태 비저장이며 동일한 경계 도구 의미론을 사용합니다:

프로젝트 파일, 환경 비밀, 브라우저 프로필, 운영 체제 자격 증명 또는 네트워크 리소스를 읽지 않습니다. 각 호출은 완전한 경계 프로젝트를 제공하고 결과를 받습니다.

pnpm mcp:build
node apps/mcp-server/dist/apps/mcp-server/src/server.js

한 번 빌드한 다음 호스트가 Node를 직접 실행하도록 구성하십시오. 이렇게 하면 패키지 관리자 빌드 출력이 아닌 개행 프레임 MCP JSON용으로 stdout이 예약됩니다. 복제, 설치 및 빌드 후의 예제 호스트 어댑터:

{
  "mcpServers": {
    "ps3d": {
      "command": "node",
      "args": ["apps/mcp-server/dist/apps/mcp-server/src/server.js"],
      "cwd": "<absolute-path-to-ps3d-repository>"
    }
  }
}

서버는 로컬 stdio를 통해 최신 MCP 2026-07-28 디스커버리와 2025년대 레거시 초기화를 지원합니다. ps3d_guide로 시작하여, ps3d_find_commands를 사용해 자연어 목표를 실행하지 않고 한정된 레시피로 매핑합니다. 열 개의 도구는 ps3d_guide, ps3d_find_commands, ps3d_capabilities, ps3d_inspect_project, ps3d_design_health, ps3d_analyze_vehicle, ps3d_electromechanical_catalog, ps3d_preview_electromechanical, ps3d_preview_operation, ps3d_apply_preview입니다.

Circuit-to-3D 프리뷰는 프로젝트가 소유한 일반 카탈로그만 참조하며 정확한 작업(operation)과 영수증(receipt)을 반환합니다. 그 결과를 적용하거나 활성 브라우저 세션을 제어하지 않습니다. Apply는 일치하는 SHA-256 프리뷰 영수증과 confirmed: true만 허용하고 새 프로젝트를 반환하며 외부 상태를 기록하지 않습니다. 확인(confirmation) 플래그는 인간 검토에 대한 암호학적 증명이 아니라 호스트의 단정(assertion)이고, 영수증은 서명이 아니라 무결성 체크섬입니다. 외부 호출은 열려 있는 브라우저 프로젝트를 제어하지 않습니다. 호스트가 완전한 프로젝트 값을 제공하면 사용자가 반환된 사본을 검토한 뒤 열거나 가져옵니다. 전체 연결, 명령 네임스페이스 및 안전 계약은 docs/AI_COLLABORATION.md에 있습니다. Vercel 원격 전송은 HTTPS 인증, 범위 필터링, 엄격한 Origin 처리, 1 MB 요청 상한과 신원별 속도 제한을 추가하지만 프로젝트 페이로드를 저장하지 않습니다.

Python 3.11+는 sdk/python 아래의 프로젝트 소유 표준 라이브러리 클라이언트를 사용할 수 있습니다. 호출자는 명령, 작업 디렉터리, 인메모리 프로젝트/작업, 영수증 및 확인 여부를 명시적으로 제공합니다. 클라이언트는 shell=False를 사용하고 네트워크 코드를 포함하지 않으며 파일이나 비밀을 자동으로 탐색하지 않습니다. 자세한 내용은 docs/PYTHON_LINKING.md에 문서화되어 있습니다. 실제 프로세스 교환은 개인 또는 IT가 승인한 개발/CI 환경으로 미루어집니다.

아키텍처, 근거 및 스크린샷

시맨틱 프로젝트와 개정 이력이 신뢰 원천입니다. worker/kernel, 테셀레이션된 프리뷰, SVG, Three.js 상태는 폐기 가능한 파생 산출물입니다. 아키텍처는 docs/architecture/PHASE_1_WORKBENCH_ARCHITECTURE.md에 문서화되어 있고, 결정 사항은 docs/adr에 있습니다.

브라우저 검토 스크린샷(검토한 상단 리본, 기능 이력, 3D Exchange Center, 가져온 참조, PDF 워크플로우, 레이어형 차량 엔지니어링 레이아웃, Design Health Center 포함)은 docs/screenshots 아래에 있습니다. 로컬 검증 근거는 docs/PHASE_1_LOCAL_EVIDENCE.md에 기록되어 있습니다. 의존성 및 조력 자료는 기본 거부(deny-by-default) 방식으로 관리하며 provenance에 기록합니다. 저장소에는 어떤 키, 토큰, .env 파일, 비공개 경로, 사용자 데이터 또는 복사된 CAD 자산이 들어 있어서는 안 됩니다.

배포 상태

vercel.json은 강화된 Vite 배포와 웹 표준 API 함수를 정의합니다. Supabase는 identity를 담당하며, 마이그레이션은 토큰 해시와 집계 요율 카운터만 저장합니다. 정확한 무료 티어 설정, 환경 경계, 실시간 검증 및 장애 대응은 docs/PUBLIC_DEPLOYMENT.md에 있고, 출시를 차단하는 릴리스 검토는 docs/RELEASE_CHECKLIST.md에 있습니다. 공급자의 무료 티어에는 할당량이 있으며, 무제한 또는 영구 무료 서비스를 약속하지 않습니다.

라이선스

원본 프로젝트 자료는 MIT 라이선스에 따라 라이선스가 부여됩니다. 제3자 구성 요소는 각자의 라이선스와 고지 사항을 유지합니다. LICENSE, THIRD_PARTY_NOTICES.md, INDEPENDENT_DEVELOPMENT.md, provenance/SOURCE_POLICY.md를 참조하십시오.