COM 상호운용을 통해 SolidWorks를 자동화하는 Node.js MCP 서버입니다. CAD 자동화 작업을 위해 SolidWorks에 AI 비서(Claude Desktop 등)를 연결합니다.

프로젝트 상태: 알파 / 실험 중

이 프로젝트는 현재 활발히 개발 중입니다. 아키텍처가 완성되고 기본 연산(스케치 평면, 단순 압출)이 시연되었지만, 대부분의 도구는 라이브 SolidWorks 인스턴스에 대해 검증되지 않았습니다. 거친 모서리, COM 특이점, 불완전한 기능 등이 예상됩니다. 기여 및 테스트 보고서는 매우 환영합니다.

작동 원리

서버는 stdio 위의 MCP 도구로 SolidWorks 작업을 노출합니다. 지능형 라우팅 계층은 Node.js COM 브리지의 주요 한계를 처리합니다: 13+ 매개변수를 가진 메서드는 직접 COM 호출로 종종 실패합니다.

• 단순 연산(12개 이상 파라미터) - [[T0]를 통한 직접 COM 호출
• 복잡한 연산 (13+ 파라미터) - SolidWorks에서 자동으로 생성되는 VBA 매크로
• 실패한 연산 - 오류 맥락을 포함한 자동 대체

선수 조건

• Windows 10/11 (필수 - COM 상호 운용은 Windows 전용)
• SolidWorks 2021-2025 (라이선스 완료, 설치됨)
• Node.js 20+
• MCP 호환 클라이언트(Claude Desktop 등)

SolidWorks MCP Server

A Node.js MCP server for automating SolidWorks via COM interop. Connects AI assistants (Claude Desktop, etc.) to SolidWorks for CAD automation tasks.

Project Status: Alpha / Experimental

This project is under active development. While the architecture is in place and basic operations (sketch planes, simple extrusions) have been demonstrated, most tools have not been validated against a live SolidWorks instance. Expect rough edges, COM quirks, and incomplete functionality. Contributions and testing reports are very welcome.

How It Works

The server exposes SolidWorks operations as MCP tools over stdio. An intelligent routing layer handles a key limitation of Node.js COM bridges: methods with 13+ parameters often fail via direct COM calls.

• Simple operations (12 params or fewer) - Direct COM call via winax
• Complex operations (13+ params) - Auto-generated VBA macro executed by SolidWorks
• Failed operations - Automatic fallback with error context

Prerequisites

• Windows 10/11 (required - COM interop is Windows-only)
• SolidWorks 2021-2025 (licensed, installed)
• Node.js 20+
• An MCP-compatible client (Claude Desktop, etc.)

Installation

git clone https://github.com/vespo92/SolidworksMCP-TS.git
cd SolidworksMCP-TS

# Install dependencies (compiles winax native module for your system)
npm install

# Build TypeScript
npm run build

Note: The winax native module must be compiled locally on each Windows machine. Global npm installation does not work.

Configure Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "solidworks": {
      "command": "node",
      "args": ["C:/path/to/SolidworksMCP-TS/dist/index.js"],
      "env": {
        "SOLIDWORKS_PATH": "C:\\Program Files\\SOLIDWORKS Corp\\SOLIDWORKS",
        "ADAPTER_TYPE": "winax-enhanced"
      }
    }
  }
}

Available Tools

The server registers tools across these categories: