solidworks-mcp

MCP-Server, der Claude Desktop über die COM-API mit SolidWorks verbindet und die automatisierte Analyse von Blechteilen für die Werkzeug- und Stanzindustrie ermöglicht.

Was es tut

Ein Werkzeugbauingenieur kann Claude Desktop öffnen und sagen:

„Öffne bracket.step, nenne mir die Blechdicke, alle Bohrungsdurchmesser, die Anzahl der Biegungen und exportiere die Abwicklung als DXF.“

Claude ruft die MCP-Tools auf, um:

1. Die STEP-Datei in SolidWorks zu öffnen

2. Blech zu erkennen, Dicke + K-Faktor auszulesen

3. Alle Bohrungen zu erfassen und nach Durchmesser zu gruppieren

4. Jede Biegung zu zählen und zu charakterisieren (Winkel, Radius, Länge)

5. Das Teil abzuwickeln und die Abwicklung als DXF zu exportieren

6. Einen strukturierten Analysebericht zurückzugeben

Zeitersparnis: 60–90 Minuten manuelle Inspektion → ~60 Sekunden.

Related MCP server: Civil3D MCP Server

Testen ohne SolidWorks

Der Großteil dieses Projekts benötigt eine lizenzierte SolidWorks-Installation, aber analyze_step_standalone läuft überall dort, wo CadQuery läuft. Anhand der Testvorlage in diesem Repository:

pip install -e .
conda install -c cadquery cadquery   # see docs/INSTALL.md for the pip route
python -c "
from mcp.server.fastmcp import FastMCP
from solidworks_mcp.solidworks_bridge import SolidWorksBridge
from solidworks_mcp.tools.analysis import register
import json
mcp = FastMCP('demo'); register(mcp, SolidWorksBridge())
fn = mcp._tool_manager._tools['analyze_step_standalone'].fn
print(json.dumps(fn(file_path='tests/fixtures/sample_part.step'), indent=2))
"

Tatsächliche Ausgabe für sample_part.step — eine 100 x 60 x 2 mm große Platte mit vier Ø6 mm Durchgangsbohrungen (gekürzt; das vollständige Ergebnis enthält außerdem file_path, die einzelnen Begrenzungsrahmenwerte und einen Hinweis zu den Einheiten):

{
  "file_size_kb": 33.48,
  "volume_mm3": 11773.81,
  "surface_area_mm2": 12564.6,
  "bounding_box": {
    "dimensions_mm": [100.0, 60.0, 2.0]
  },
  "center_of_mass_mm": { "x": 0.0, "y": 0.0, "z": 1.0 },
  "face_count": 10,
  "face_types": { "PLANE": 6, "CYLINDER": 4 },
  "estimated_thickness_mm": 2.0,
  "is_likely_sheet_metal": true
}

Die vier Bohrungen erscheinen als die vier zylindrischen Flächen, und die Dicke wird aus der kleinsten Begrenzungsrahmen-Abmessung abgeleitet.

Voraussetzungen

SolidWorks muss auf demselben Rechner wie dieser Server installiert und aktiviert sein. Die COM-API benötigt die vollständige Anwendung — SolidWorks PDM oder Viewer sind nicht ausreichend.

Schnellinstallation

REM 1. Clone the repository
git clone https://github.com/tmkaio/solidworks-mcp.git
cd solidworks-mcp

REM 2. Create a virtual environment
python -m venv .venv
.venv\Scripts\activate

REM 3. Install the package
pip install -e .

REM 4. (Optional) Install CadQuery for standalone STEP analysis
conda install -c cadquery cadquery

Claude Desktop konfigurieren

Kopieren Sie claude_desktop_config.example.json und übernehmen Sie die Inhalte in Ihre Claude-Konfiguration:

Speicherort: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "solidworks": {
      "command": "C:\\path\\to\\solidworks-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "solidworks_mcp.server"],
      "env": {
        "PYTHONPATH": "C:\\path\\to\\solidworks-mcp\\src",
        "LOG_LEVEL": "INFO"
      }
    }
  }
}

Starten Sie Claude Desktop neu. In der Chat-Symbolleiste sollte ein Hammer-Symbol (🔨) erscheinen.

Eine Schritt-für-Schritt-Anleitung finden Sie unter docs/INSTALL.md.

Beispielkonversation

You: Open C:\parts\door_hinge.step and give me a full analysis.

Claude: [calls open_file, get_part_info, analyze_holes, analyze_bends]

        The door hinge is a sheet metal part:
        - Thickness: 2.00 mm (K-factor: 0.44)
        - Bounding box: 120 x 80 x 45 mm
        - Mass: 312 g
        - 12 holes: Ø6mm x 4, Ø8mm x 4, Ø12mm x 4
        - 3 bends: 90° x R2mm (two) and 45° x R3mm (one)
        - Complexity: medium

You: Export the flat pattern as DXF to C:\output\hinge_flat.dxf

Claude: [calls flatten_part, export_dxf, unflatten_part]
        Flat pattern exported: C:\output\hinge_flat.dxf (18.4 KB)
        Flat dimensions: 310 x 80 mm

Verfügbare Tools

Verbindung

Dateien

Analyse

Blech

Export

Benutzerdefinierte Eigenschaften & Materialien

Konfigurationen

Messungen

Feature-Verwaltung

Zeichnungen

Baugruppen

Einschränkungen (v0.1)

• Baugruppenunterstützung ist schreibgeschützt. Komponenten, Stücklisten, Verknüpfungen und Masse können gelesen werden; das Erstellen von Verknüpfungen oder das Einfügen von Komponenten wird nicht unterstützt.

• Keine parametrische Bearbeitung. Features können aufgelistet, unterdrückt und wiederhergestellt werden, aber Bemaßungen können nicht gesteuert werden.

• STEP-Dateien werden als „dumme“ Volumenkörper importiert. convert_to_sheet_metal muss ausgeführt werden, bevor die Biegeanalyse irgendetwas zurückgibt.

• Kein Streifenlayout / keine Folgewerkzeugkonstruktion.

• Nur Windows und erfordert eine lizenzierte lokale SolidWorks-Installation — die COM-API benötigt die vollständige Anwendung. Die einzige Ausnahme ist analyze_step_standalone, das überall via CadQuery läuft.

Roadmap

Darüber hinaus sind Umformbarkeits- und Hinterschneidungserkennung, GD&T-Bemaßung auf generierten Zeichnungen und Nesting-Integration plausible Richtungen, aber es ist nichts verbindlich zugesagt.

Entwicklung

Die Testsuite mockt die COM-Ebene, daher ist zum Ausführen keine SolidWorks-Lizenz erforderlich:

pip install -e ".[dev]"
ruff check src tests
pytest -v

Unter Windows ist das die ganze Geschichte: Alle 54 Tests laufen. CI führt dieselben zwei Befehle auf Linux aus und installiert die reinen Python-Abhängigkeiten direkt statt über pip install -e ., weil pywin32 kein Linux-Wheel hat.

Zwei Gruppen überspringen sich selbst, anstatt fehlzuschlagen, wenn eine Abhängigkeit fehlt:

• die connect()- / disconnect()-Tests patchen pythoncom und win32com.client namentlich, benötigen also pywin32 und laufen nur unter Windows;

• analyze_step_standalone benötigt CadQuery.

Alles andere — der COM-Aufrufvertrag, die Bohrungs- und Biegeextraktion, die Einheitenumrechnung, die Feature-Traversierung — läuft überall.

Logs

Server-Logs: %USERPROFILE%\.solidworks-mcp\logs\server.log

Claude-Desktop-Logs: %APPDATA%\Claude\logs\

Lizenz

MIT