ZWCAD Platform MCP

Управление локальным сервисом ZWCAD для Windows через протокол MCP. Может вызываться из WorkBuddy и других клиентов, поддерживающих MCP stdio. Проект предоставляет 26 инструментов автоматизации ZWCAD.

Возможности

Related MCP server: AutoCAD MCP Server

Требования к окружению

• Windows 10/11

• ZWCAD, после запуска должен быть открыт хотя бы один DWG

• Python 3.9 или новее

• Рекомендуется, чтобы разрядность Python и ZWCAD совпадала

При установке Python отметьте галочкой Add Python to PATH. Также можно выполнить py -3 --version из командной строки, чтобы убедиться, что установка прошла успешно.

Установка

1. Распакуйте проект в фиксированный каталог, например D:\Tools\ZWCAD-Platform-MCP.

2. Дважды щёлкните install.bat.

3. Дождитесь, пока скрипт создаст .venv и установит зависимости.

Автономный запуск для тестирования

1. Запустите ZWCAD и откройте тестовый DWG.

2. Дважды щёлкните start.bat.

3. Окно командной строки остаётся открытым и ожидает подключения клиента — это нормально; у службы MCP stdio нет веб-интерфейса.

Настройка WorkBuddy

Откройте workbuddy-mcp.json и замените оба вхождения D:\\YOUR_PATH на фактический каталог проекта. Например, если проект находится в 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"}
    }
  }
}

Объедините конфигурацию mcpServers с конфигурацией MCP в WorkBuddy, сохраните изменения и перезапустите WorkBuddy.

Первичная проверка

Рекомендуется последовательно вызвать в тестовом DWG:

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

Если на первом шаге не удаётся установить соединение, проверьте:

• ZWCAD запущен и открыт DWG;

• WorkBuddy использует .venv\Scripts\python.exe;

• WorkBuddy полностью перезапущен после изменения конфигурации;

• антивирусное ПО не блокирует доступ Python к локальному COM-сервису.

Если в старой версии возникала ошибка mbcs codec can't decode bytes, используйте server.py из последней версии этого проекта и полностью перезапустите WorkBuddy. Сервис заставляет comtypes генерировать обёртки интерфейсов ZWCAD в памяти, что позволяет избежать сбоев при чтении сгенерированных файлов с системной кодовой страницей ANSI.

Безопасность использования

Некоторые инструменты напрямую изменяют текущий чертёж. Перед выполнением удаления, закрытия документа, перезаписи сохранения или изменения системных переменных рекомендуется сохранить резервную копию и требовать ручного подтверждения операции в WorkBuddy.

Лицензия

Лицензия MIT, подробнее см. в LICENSE.