ZWCAD Platform MCP

MCP 프로토콜을 통해 ZWCAD의 Windows 로컬 서비스를 제어하며, WorkBuddy 및 기타 MCP stdio를 지원하는 클라이언트에서 호출할 수 있습니다. 이 프로젝트는 26개의 ZWCAD 자동화 도구를 제공합니다.

기능

Related MCP server: AutoCAD MCP Server - Codex Edition

환경 요구 사항

• Windows 10/11

• ZWCAD, 시작 후 최소 1개의 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 구성을 WorkBuddy의 MCP 구성에 병합하고 저장한 후 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에서 작업 전 수동 확인을 요구하는 것을 권장합니다.

License

MIT License, 자세한 내용은 LICENSE를 참조하세요.