Skip to main content
Glama
Said-AER

SolidWorks MCP Bridge

by Said-AER

SolidWorks MCP Bridge 🌉 ⚙️

Model Context Protocol (MCP) 기반 통합 서버 및 브리지로, 로컬 언어 모델(Ollama 경유)을 SolidWorks의 COM API와 연결합니다.

qwen3:8b 및 qwen3:30b-a3b와 같은 LLM이 설계 상태를 검사하고, 피처 트리를 분석하고, 치수를 읽고, 방정식을 조회하고, 질량 물성치를 추출하고, 기술 파일을 자동화되고 구조화된 방식으로 내보낼 수 있습니다.


🎯 프로젝트 범위

  • 레벨 1 (현재 단계 - 읽기): 부품, 어셈블리, 치수, 방정식, 질량 및 FEA 연구에 대한 비파괴 검사.

  • 레벨 2 (향후 단계 - 편집): 치수, 전역 변수의 파라메트릭 수정 및 제어된 재구성.

  • 레벨 3 (향후 단계 - 생성): 2D/3D 스케치, 피처 및 자동화된 매크로 생성.


Related MCP server: solidworks-mcp

📂 프로젝트 구조

LOCAL LLM/
├── requirements.txt         # Dependencias Python (mcp, pywin32, pydantic, ollama, etc.)
├── pyproject.toml           # Configuración del paquete y testing
├── .env.example             # Plantilla de variables de entorno
├── .env                     # Configuración activa local
├── src/
│   └── sw_bridge/
│       ├── config.py         # Carga de configuración (pydantic-settings)
│       ├── logging_config.py # Logging estructurado JSON por sesión
│       ├── server.py         # Servidor MCP (fastmcp / stdio / sse)
│       ├── sw_connection/    # Conexión COM a SolidWorks
│       │   ├── connector.py  # Singleton y reconexión automática
│       │   ├── exceptions.py # Excepciones tipadas
│       │   └── models.py     # Modelos de datos Pydantic
│       └── tools/            # Herramientas de Nivel 1
│           ├── document_tools.py
│           ├── feature_tree_tools.py
│           ├── dimension_tools.py
│           ├── mass_props_tools.py
│           ├── export_tools.py
│           └── fea_tools.py
├── tests/                    # Pruebas automatizadas (pytest)
├── scripts/
│   ├── test_tool_calling.py  # Validación de llamadas a funciones con Ollama
│   └── smoke_test.py         # Smoke test contra SolidWorks
└── docs/                     # Especificaciones y resolución de problemas
    ├── alcance.md
    ├── tool_schemas.md
    └── troubleshooting.md

🚀 설치 및 시작

1. 가상 환경 활성화

.\sw-mcp-env\Scripts\activate

2. Ollama에서 모델 확인

도구 지원 모델이 준비되어 있는지 확인하세요:

ollama list
ollama show qwen3:8b

3. 로컬 LLM으로 도구 호출(Tool Calling) 테스트

.\sw-mcp-env\Scripts\python scripts/test_tool_calling.py

4. 테스트 스위트 실행

.\sw-mcp-env\Scripts\pytest tests/ -v

5. MCP 서버 시작(stdio 모드)

.\sw-mcp-env\Scripts\python -m sw_bridge.server --transport stdio

🛠️ 사용 가능한 도구 (레벨 1)

도구

설명

check_solidworks_status

SolidWorks가 COM을 통해 응답하는지 확인합니다.

get_active_document_info

유형, 경로, 구성 및 저장 상태를 가져옵니다.

list_open_documents

세션에 로드된 모든 문서를 나열합니다.

get_feature_tree

전체 피처 트리(FeatureManager)를 추출합니다.

get_feature_details

피처의 정의와 매개변수를 검사합니다.

list_dimensions

모델 또는 피처의 숫자 치수를 나열합니다.

get_equations

방정식 관리자의 방정식과 전역 변수를 읽습니다.

get_mass_properties

질량(kg), 부피, 무게 중심 및 관성을 계산합니다.

export_step

활성 모델을 중립 STEP 형식으로 내보냅니다.

export_pdf

2D 도면 또는 활성 뷰를 PDF로 내보냅니다.

export_screenshot

고해상도 스크린샷을 PNG 형식으로 저장합니다.

list_simulation_studies

유한 요소 해석(FEA) 연구를 나열합니다.

get_simulation_study_results

von Mises 응력 및 안전계수를 조회합니다.


⚙️ Antigravity / Claude Desktop에서 MCP 서버로 구성

다음 구성을 MCP 클라이언트에 추가하세요:

{
  "mcpServers": {
    "solidworks-bridge": {
      "command": "C:\\Users\\said\\Desktop\\LOCAL LLM\\sw-mcp-env\\Scripts\\python.exe",
      "args": ["-m", "sw_bridge.server", "--transport", "stdio"],
      "cwd": "C:\\Users\\said\\Desktop\\LOCAL LLM"
    }
  }
}

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    MCP server that exposes CAD geometry reasoning over STEP files to LLMs, allowing natural language queries about parts, assemblies, dimensions, holes, and mass properties.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP bridge server for SolidWorks that enables AI assistants to control SolidWorks programmatically via COM automation.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI (e.g., Claude) to control SolidWorks via natural language, automating part creation, sketching, and feature operations through the Model Context Protocol.
    1
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    An MCP server that drives SolidWorks 2023+ on Windows, exposing CAD operations like sketching, extrusions, assemblies, and exports through tools for AI assistants like Kimi and Claude.
    1
    -