solidworks-mcp

English | 简体中文

MCP server that drives a running SOLIDWORKS session over its COM API. It attaches to the session you already have open; it does not launch SOLIDWORKS, register an add-in or touch the network.

192 tools. Covered vs not covered: COVERAGE.md.

Requirements

Windows, SOLIDWORKS installed and already running, Python 3.10+.

Related MCP server: solidworks-mcp

Install

git clone https://github.com/Slacker-LLC/solidworks-mcp.git
cd solidworks-mcp
py -3 -m venv .venv
.venv\Scripts\python.exe -m pip install .

The command is solidworks-mcp; the distribution is solidworks-mcp-server.

Claude:

{
  "mcpServers": {
    "solidworks-mcp": {
      "command": "C:\\path\\to\\.venv\\Scripts\\solidworks-mcp.exe"
    }
  }
}

Codex CLI (~/.codex/config.toml):

[mcp_servers.solidworks-mcp]
command = 'C:\path\to\.venv\Scripts\solidworks-mcp.exe'

Configuration

Lengths are _mm, angles _deg. Geometry is passed as a selection object ({"edges": [4, 6, 9]}, {"planes": ["front"]}); indices describe the current model, so re-list them after a geometry change.

Testing

python -m unittest discover -s tests -p 'test_*.py'     # offline
python tests/live_p0_regression.py                      # live, SOLIDWORKS running

Contributor notes: CONTRIBUTING.md · release process: RELEASING.md.

License

Apache License 2.0 — see LICENSE and the Simplified Chinese note. Copyright 2026 JIALE LIU.