ZWCAD Platform MCP

Controla el servicio local de ZWCAD en Windows mediante el protocolo MCP, y puede ser invocado por WorkBuddy y otros clientes compatibles con MCP stdio. El proyecto ofrece 26 herramientas de automatización para ZWCAD.

Funciones

Related MCP server: CAD MCP Server

Requisitos del entorno

• Windows 10/11

• ZWCAD, con al menos un DWG abierto tras el inicio

• Python 3.9 o superior

• Se recomienda que la arquitectura de bits de Python y ZWCAD sea la misma

Al instalar Python, marque la opción Add Python to PATH. También puede ejecutar py -3 --version desde la línea de comandos para confirmar que la instalación se realizó correctamente.

Instalación

1. Descomprima el proyecto en un directorio fijo, por ejemplo D:\Tools\ZWCAD-Platform-MCP.

2. Haga doble clic en install.bat.

3. Espere a que el script cree .venv e instale las dependencias.

Prueba de inicio independiente

1. Inicie ZWCAD y abra un DWG de prueba.

2. Haga doble clic en start.bat.

3. Es normal que la ventana de comandos permanezca abierta esperando la conexión del cliente; el servicio MCP stdio no tiene interfaz web.

Configuración de WorkBuddy

Abra workbuddy-mcp.json y reemplace las dos apariciones de D:\\YOUR_PATH por el directorio real donde se encuentra el proyecto. Por ejemplo, si el proyecto está en D:\Tools\ZWCAD-Platform-MCP:

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

Fusione la configuración de mcpServers en la configuración MCP de WorkBuddy, guarde y reinicie WorkBuddy.

Primera verificación

Se recomienda invocar en orden los siguientes comandos en un DWG de prueba:

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")

Si el primer paso falla al conectar, confirme que:

• ZWCAD ya está iniciado y con un DWG abierto;

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

• WorkBuddy se reinició por completo después de modificar la configuración;

• El antivirus no está bloqueando el acceso de Python al servicio COM local.

Si en versiones anteriores aparecía el error mbcs codec can't decode bytes, utilice la versión más reciente de server.py de este proyecto y reinicie WorkBuddy por completo. El servicio hace que comtypes genere los wrappers de interfaz de ZWCAD en memoria, evitando que falle la lectura de los archivos generados cuando la página de códigos ANSI del sistema no es compatible.

Seguridad de uso

Algunas herramientas modifican directamente el dibujo actual. Antes de ejecutar eliminaciones, cerrar documentos, sobrescribir guardados o modificar variables del sistema, se recomienda guardar una copia de seguridad y solicitar confirmación manual antes de la operación en WorkBuddy.

Licencia

Licencia MIT; consulte LICENSE para más detalles.