COMの相互運用を通じてSolidWorksを自動化するためのNode.js MCPサーバーです。CAD自動化作業のために、AIアシスタント(Claude Desktopなど)をSolidWorksに接続します。

プロジェクトステータス:アルファ/実験

このプロジェクトは現在も積極的に開発中です。アーキテクチャは整い、基本的な操作(スケッチプレーンや単純な押出)は実証されていますが、ほとんどのツールはライブのSolidWorksインスタンスに対して検証されていません。粗い部分やCOMの特例、機能不完全なものが予想されます。貢献やテストレポートは大歓迎です。

仕組み

サーバーはstdio上のMCPツールとしてSolidWorks操作を公開します。インテリジェントルーティング層はNode.js COMブリッジの重要な制限を処理します。すなわち、13+パラメータのメソッドは直接COMコールで失敗することが多いのです。

• 単純な操作(12パラム以下)- winaxを経由した直接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: