英语 |简体中文

让AI代理（Claude代码、光标等）在运行ZW3D 2025+**的中建模部分，并检查结果（截图、体积、边界框）。 目标是ZW3D，不是ZWCAD。

整个MCP服务器就是一个DLL**，运行在ZW3D内部，通过HTTP运行MCP。没有Python，没有Node，没有额外的进程。

快速开始

1. 从Releases下载zw3d-mcp-vX.Y.Z-win64.zip并解压。
2. 关闭ZW3D，然后复制zw3dmcp.dll到%APPDATA%\ZWSOFT\ZW3D\ZW3D 2025\custom\apilibs（如果缺少文件夹，请创建;新版本更改年份）。
3. 启动ZW3D。输出窗口显示[ZW3D-MCP] MCP endpoint: http://127.0.0.1:47823/mcp。如果没有，执行命令McpStart。
4. 在客户端注册端点：

光标：{"mcpServers": {"zw3d": {"url": "http://127.0.0.1:47823/mcp"}}}。 仅限 Stdio 的客户端需要像 npx -y mcp-remote http://127.0.0.1:47823/mcp（未验证）这样的桥接器。 5. 问人工智能：“ping ZW3D”。

更多细节和故障排除：docs/INSTALL.md。命令 McpStart / McpStop 在 ZW3D 内切换服务。

配置（环境变量，启动ZW3D前设置）

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)

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