solidworks-mcp

# 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

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.