Сервер Node.js MCP для автоматизации SolidWorks через COM-взаимодействие. Соединяет AI-ассистентов (Claude Desktop и др.) с SolidWorks для задач автоматизации CAD.

Статус проекта: Альфа / Экспериментальный

Этот проект находится в активной разработке. Хотя архитектура уже на практике и продемонстрированы базовые операции (плоскости эскиза, простые экструзии), большинство инструментов не прошли проверку на живом экземпляре SolidWorks. Ожидайте грубых краёв, особенностей COM и неполной функциональности. Вклад и отчёты по тестированию приветствуются.

Как это работает

Сервер отображает операции SolidWorks в виде MCP-инструментов поверх stdio. Интеллектуальный маршрутизирующий слой обрабатывает ключевое ограничение Node.js COM-мостов: методы с 13+ параметрами часто выходят из строя при прямых COM-вызовах.

• Простые операции (12 параметров или меньше) - Прямой вызов COM через winax
• Сложные операции (13+ параметров) - Автоматически сгенерируемый макрос VBA, выполняемый SolidWorks
• Неудачные операции - Автоматический запасной вариант с контекстом ошибки

Предварительные требования

• Windows 10/11 (обязательно — COM interop только для 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: