Skip to main content
Glama
yimu0824

solidworks-mcp

by yimu0824

# SolidWorks MCP Server

A Model Context Protocol (MCP) bridge server for SolidWorks, enabling AI assistants (like Codex) to directly interact with SolidWorks through COM automation.

Features

  • Connect to SolidWorks and control it programmatically

  • Open, save, close SolidWorks documents (.sldprt / .sldasm / .slddrw)

  • Read document info: features, bodies, mass properties, custom properties

  • Export to STEP / IGES / STL formats

  • Read file metadata without launching SolidWorks GUI

  • Full MCP integration: tools + resources

Related MCP server: solidworks-mcp

Prerequisites

  • SolidWorks (2020+ recommended) installed on Windows

  • Python 3.10+

  • pywin32 (pip install pywin32)

  • mcp (pip install mcp)

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/solidworks-mcp.git
cd solidworks-mcp

# Install dependencies
pip install -r requirements.txt

Usage

1. Standalone Mode

Run the MCP server directly:

python server.py

2. Codex Integration

Add the following to your Codex config.toml (usually at ~/.codex/config.toml):

[mcp_servers.solidworks]
command = "python"
args = ["C:/path/to/solidworks-mcp/server.py"]
startup_timeout_sec = 60

[mcp_servers.solidworks.env]
PYTHONIOENCODING = "utf-8"

Restart Codex after updating the config.

3. Using the Tools

Once connected, you can ask your AI assistant to:

  • "Connect to SolidWorks and open part.sldprt"

  • "List all features in the current document"

  • "Export the model as STEP"

  • "Get the mass properties"

  • "Show me all custom properties"

Available MCP Tools

Tool

Description

sw_connect

Connect to SolidWorks (launch if not running)

sw_open_document

Open a SolidWorks document

sw_get_document_info

Get full document information

sw_list_features

List all modeling features

sw_list_bodies

List all solid bodies

sw_get_mass_properties

Get mass, volume, center of mass

sw_get_custom_properties

Read custom properties

sw_export

Export to STEP / IGES / STL

sw_save

Save current document

sw_save_as

Save document to a new path

sw_close_document

Close a document

sw_rebuild

Force rebuild the model

sw_read_file_info

Read file info without launching GUI

sw_quit

Exit SolidWorks

MCP Resources

  • solidworks://status - Current connection status and active document info

  • solidworks://file/{path} - Read file metadata without opening SolidWorks

Architecture

solidworks-mcp/
├── server.py          # MCP Server (tools + resources)
├── sw_bridge.py       # SolidWorks COM bridge core
└── requirements.txt   # Python dependencies

The bridge communicates with SolidWorks via the Windows COM automation interface (SldWorks.Application). The MCP server wraps these operations into standard MCP tools and resources.

Limitations

  • Windows only (COM automation is Windows-specific)

  • SolidWorks must be installed locally

  • Some operations may require SolidWorks to be running with a valid license

  • STL export quality settings may vary by SolidWorks version

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    C
    quality
    A
    maintenance
    Python MCP server for SolidWorks automation with 109 tools covering the full CAD lifecycle. Enables AI-assisted design workflows through COM automation on Windows.
    100
    72
    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.
    -
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for controlling a live SOLIDWORKS session through the Windows COM API, enabling native CAD operations like sketches, features, bodies, views, and exports, plus transactional plans and vectorization.
    1
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server that controls SolidWorks via COM, enabling CAD automation with 138 tools for sketching, 3D features, assemblies, drawings, and more.
    MIT