MCP Directory

How to add SolidWorks MCP to Windsurf

Automate SolidWorks over COM from your AI client: sketches, features, drawings, exports and VBA generation (alpha). Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 193★ · stdio · no auth

Windsurf config for SolidWorks MCP

git clone https://github.com/vespo92/SolidworksMCP-TS.git && cd SolidworksMCP-TS && npm install && npm run build
{
  "mcpServers": {
    "solidworks-mcp": {
      "command": "node",
      "args": [
        "C:/path/to/SolidworksMCP-TS/dist/index.js"
      ],
      "env": {
        "SOLIDWORKS_PATH": "C:\\Program Files\\SOLIDWORKS Corp\\SOLIDWORKS",
        "ADAPTER_TYPE": "winax-enhanced"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the SolidWorks MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5SolidWorks MCP's tools become available to Cascade.

Before you start

  • Windows 10/11 (COM interop is Windows-only)
  • Licensed SolidWorks 2021–2025 installed
  • Node.js 20+ (npm install compiles the winax native module locally)

What SolidWorks MCP can do in Windsurf

create_part

Create a new part document.

create_extrusion

Extrude a sketch into a solid feature.

create_revolve

Create a revolve feature.

create_sweep

Create a sweep feature.

create_loft

Create a loft feature.

create_fillet

Add a fillet to edges.

create_chamfer

Add a chamfer to edges.

create_sketch

Open a sketch on a plane.

Security

Alpha software driving a licensed CAD seat over COM — most tools are untested against live SolidWorks, so run it on copies of parts rather than production assemblies. Complex operations execute auto-generated VBA macros inside SolidWorks, which is effectively arbitrary code execution in that session; no credentials or network access are involved.

SolidWorks MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the SolidWorks MCP config there under the "mcpServers" key and restart the client.

Is SolidWorks MCP safe to use with Windsurf?

Alpha software driving a licensed CAD seat over COM — most tools are untested against live SolidWorks, so run it on copies of parts rather than production assemblies. Complex operations execute auto-generated VBA macros inside SolidWorks, which is effectively arbitrary code execution in that session; no credentials or network access are involved.

Is SolidWorks MCP production-ready?

No — the author labels it alpha/experimental. Basic sketching and simple extrusions are demonstrated; drawings, exports and analysis tools have only mock/unit tests, and there is no CI against a real SolidWorks instance yet. Treat it as a promising testbed and report results.

Why does it generate VBA macros instead of always calling the API?

Because Node.js COM bridges fail on SolidWorks methods with 13+ parameters (FeatureExtrusion3 takes 20+). The complexity analyzer sends small calls direct via winax and generates a VBA macro — executed by SolidWorks — for the big ones, falling back automatically when a call fails.

Can I run it without SolidWorks, or on macOS/Linux?

No. COM interop is Windows-only, and the server drives a licensed SolidWorks 2021–2025 installation. Unit tests can run anywhere with USE_MOCK_SOLIDWORKS=true, but real automation needs Windows plus the app.

View repo Full SolidWorks MCP page