MMCPMarkets
AZ

a350xt/zw3d-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

2 stars 0 forks 品質 67 トレンド 24
Repository Install

MCP server + C++ plugin to drive ZW3D 2025+ from AI agents

概要

Let an AI agent (Claude Code, Cursor, …) model parts in a and check the result (screenshot, volume, bounding box). The target is ZW3D, ZWCAD. The whole MCP server is that runs inside ZW3D and speaks MCP over HTTP. No Python, no Node, no extra process. 1. Download zw3d-mcp-vX.Y.Z-win64.zip from Releases and unzip it. 2. , then copy zw3dmcp.dll to %APPDATA%\ZWSOFT\ZW3D\ZW3D 2025\custom\apilibs (create the folder if missing; change the year for newer versions). 3. Start ZW3D. The output window shows [ZW3D-MCP] MCP endpoint: http://127.0.0.1:47823/mcp. If not, run the command McpStart. 4. Register the endpoint in your client: Cursor: {"mcpServers": {"zw3d": {"url": "http://127.0.0.1:47823/mcp"}}}. Stdio-only clients need a bridge such as npx -y mcp-remote http://127.0.0.1:47823/mcp (not verified). 5. Ask the AI: "ping ZW3D". More detail and troubleshooting: docs/INSTALL.md. Commands McpStart / McpStop toggle the service inside ZW3D. The server binds to 127.0.0.

README

以下は原文 README の抜粋です。原文を見る。

ZW3D-MCP

English | 简体中文

Let an AI agent (Claude Code, Cursor, …) model parts in a running ZW3D 2025+ and check the result (screenshot, volume, bounding box). The target is ZW3D, not ZWCAD.

The whole MCP server is one DLL that runs inside ZW3D and speaks MCP over HTTP. No Python, no Node, no extra process.

AI agent ── MCP over HTTP: POST http://127.0.0.1:47823/mcp ──▶ zw3dmcp.dll (inside ZW3D)

Quick start

  1. Download zw3d-mcp-vX.Y.Z-win64.zip from Releases and unzip it.

  2. Close ZW3D, then copy zw3dmcp.dll to %APPDATA%\ZWSOFT\ZW3D\ZW3D 2025\custom\apilibs (create the folder if missing; change the year for newer versions).

  3. Start ZW3D. The output window shows [ZW3D-MCP] MCP endpoint: http://127.0.0.1:47823/mcp. If not, run the command McpStart.

  4. Register the endpoint in your client:

    claude mcp add --transport http zw3d http://127.0.0.1:47823/mcp

    Cursor: {"mcpServers": {"zw3d": {"url": "http://127.0.0.1:47823/mcp"}}}. Stdio-only clients need a bridge such as npx -y mcp-remote http://127.0.0.1:47823/mcp (not verified).

  5. Ask the AI: “ping ZW3D”.

More detail and troubleshooting: docs/INSTALL.md. Commands McpStart / McpStop toggle the service inside ZW3D.

Configuration (environment variables, set before starting ZW3D)

Variable Meaning
ZW3D_MCP_PORT Listening port (default 47823)
ZW3D_MCP_AUTOSTART=0 Do not listen automatically; use McpStart
ZW3D_MCP_TOKEN If set, every request must carry Authorization: Bearer
ZW3D_MCP_ENABLE_RUN_COMMAND=1 Enable the raw run_command tool (off by default)

Security

The server binds to 127.0.0.1 only and rejects requests whose Host or Origin is not loopback, so a web page cannot drive ZW3D through your browser. Without ZW3D_MCP_TOKEN, any local process can still call it (including run_command if enabled). Never expose the port to a network.

Tools

Units are millimetres and degrees; points are [x, y, z]. A usage guide (workflow, which tool to pick, common pitfalls) is built into the server: clients receive it automatically as the MCP instructions, and it is also available as the prompt zw3d_guide.

Session and files

Tool What it does
ping Check the connection; plugin version, active file and part
new_part Create a new part file (.Z3PRT) and make it active
save_part Save, or Save As when a path is given
close_file Close the active file (save, discard or ask)
export_step Export the active file as STEP
export_file Export to STEP, IGES, Parasolid, STL, OBJ, JT, PDF, DWG or DXF
open_file Open an existing ZW3D file
import_file Import STEP, Parasolid, SAT, IGES or STL
screenshot Capture the current view as an image (optionally from a standard view / display mode)
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者？mcpskill.org のガイドから始めましょう →