ZWCAD Platform MCP

Steuert den lokalen Windows-Dienst von ZWCAD über das MCP-Protokoll. Er kann von WorkBuddy und anderen Clients aufgerufen werden, die MCP stdio unterstützen. Das Projekt bietet 26 ZWCAD-Automatisierungswerkzeuge.

Funktionen

Related MCP server: CAD MCP Server

Systemanforderungen

• Windows 10/11

• ZWCAD, nach dem Start muss mindestens eine DWG geöffnet sein

• Python 3.9 oder höher

• Die Bit-Version von Python und ZWCAD sollte übereinstimmen

Aktivieren Sie bei der Installation von Python die Option Add Python to PATH. Sie können den Erfolg der Installation auch über den Befehl py -3 --version in der Befehlszeile überprüfen.

Installation

1. Entpacken Sie das Projekt in ein festes Verzeichnis, z. B. D:\Tools\ZWCAD-Platform-MCP.

2. Doppelklicken Sie auf install.bat.

3. Warten Sie, bis das Skript .venv erstellt und die Abhängigkeiten installiert hat.

Eigenständiger Starttest

1. Starten Sie ZWCAD und öffnen Sie eine Test-DWG.

2. Doppelklicken Sie auf start.bat.

3. Es ist normal, dass das Befehlsfenster geöffnet bleibt und auf eine Client-Verbindung wartet; der MCP-stdio-Dienst hat keine Weboberfläche.

WorkBuddy konfigurieren

Öffnen Sie workbuddy-mcp.json und ersetzen Sie die beiden Vorkommen von D:\\YOUR_PATH durch das tatsächliche Projektverzeichnis. Wenn sich das Projekt z. B. unter D:\Tools\ZWCAD-Platform-MCP befindet:

{
  "mcpServers": {
    "zwcad-platform": {
      "command": "D:\\Tools\\ZWCAD-Platform-MCP\\.venv\\Scripts\\python.exe",
      "args": ["D:\\Tools\\ZWCAD-Platform-MCP\\server.py"],
      "env": {"PYTHONUTF8": "1"}
    }
  }
}

Fügen Sie die mcpServers-Konfiguration in die MCP-Konfiguration von WorkBuddy ein, speichern Sie und starten Sie WorkBuddy neu.

Erste Überprüfung

Es wird empfohlen, in einer Test-DWG nacheinander Folgendes aufzurufen:

1. get_app_info

2. get_objects_in_model(limit=10)

3. draw_entity(entity_type="line", params={"x1":0,"y1":0,"x2":100,"y2":0})

4. zoom(mode="extents")

Wenn die Verbindung im ersten Schritt fehlschlägt, überprüfen Sie Folgendes:

• ZWCAD wurde gestartet und eine DWG ist geöffnet;

• WorkBuddy verwendet .venv\Scripts\python.exe;

• WorkBuddy wurde nach der Konfigurationsänderung vollständig neu gestartet;

• Die Antivirensoftware blockiert den Zugriff von Python auf den lokalen COM-Dienst nicht.

Wenn in einer älteren Version mbcs codec can't decode bytes aufgetreten ist, verwenden Sie die neueste Version der server.py aus diesem Projekt und starten Sie WorkBuddy vollständig neu. Der Dienst lässt comtypes die ZWCAD-Interface-Wrapper im Speicher generieren, um Fehler beim Lesen generierter Dateien mit der System-ANSI-Codepage zu vermeiden.

Nutzungssicherheit

Einige Werkzeuge ändern die aktuelle Zeichnung direkt. Bevor Sie Löschungen, das Schließen von Dokumenten, das Überschreiben von Speicherungen oder das Ändern von Systemvariablen ausführen, wird empfohlen, zuerst eine Sicherungskopie zu speichern und in WorkBuddy eine manuelle Bestätigung vor der Ausführung zu verlangen.

Lizenz

MIT-Lizenz, siehe LICENSE.