ZWCAD Platform MCP

MCP プロトコルを介して ZWCAD の Windows ローカルサービスを制御し、WorkBuddy およびその他の MCP stdio 対応クライアントから呼び出せるようにします。このプロジェクトは 26 個の ZWCAD 自動化ツールを提供します。

機能

Related MCP server: AutoCAD MCP Server

環境要件

• 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 サービス自体には Web インターフェースはありません。

WorkBuddy の設定

workbuddy-mcp.json を開き、2 箇所の 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 を参照してください。