dsh-nx

English | 简体中文

dsh-nx is an experimental DeepSeek Harness bundle for safe, local Siemens NX automation through MCP. Version 0.1.0 ships the current DSH bundle manifest, a typed MCP server, a Chinese/English-compatible modeling skill, workspace policy, mock bridge, doctor command, and an explicit protocol boundary for a future validated NX 2512 bridge.

This project is not affiliated with or endorsed by Siemens or DeepSeek.

Current status

• The MCP server, schemas, workspace confinement, mock bridge and stdio end-to-end tests run on Linux and Windows.
• The repository does not yet contain a real-NX-accepted NX 2512 bridge.
• Mock results always contain mock: true and never write .prt or STEP files.
• Do not use this release on production parts.

Install in DeepSeek Harness

DeepSeek Harness removed the old .dsh-plugin repository format. This project uses the current npm bundle form (package.json.dsh.bundle + cordis.patch.yml). From the profile where you want NX tools:

dsh plugin --profile web add github:ethanrise/dsh-nx

Tagged releases also publish a prebuilt, version-independent asset named dsh-nx.tgz. It avoids building TypeScript on the target machine:

https://github.com/ethanrise/dsh-nx/releases/latest/download/dsh-nx.tgz

Install the included skill for project-scoped discovery:

New-Item -ItemType Directory -Force .dsh\skills\nx-modeling | Out-Null
Copy-Item node_modules\dsh-nx\skills\nx-modeling\SKILL.md .dsh\skills\nx-modeling\SKILL.md

During repository development:

npm install
npm run check
DSH_NX_MODE=mock npm run dev

Configuration

Variable	Purpose
DSH_NX_WORKSPACE	Only directory the server may use for CAD files
DSH_NX_BRIDGE_URL	Loopback-only bridge URL, for example http://127.0.0.1:48161/rpc
DSH_NX_BRIDGE_TOKEN	Random bearer token shared with the local bridge
DSH_NX_TIMEOUT_MS	Tool timeout; default 30000
DSH_NX_MODE=mock	Test-only stateful mock; never creates CAD files
DSH_NX_ROOT	NX installation root used by dsh-nx-doctor

No arbitrary journal, Python, C#, or shell execution tool is exposed.

Tool surface

Health/capabilities, new part, named expression, rectangle/circle sketch, extrusion, simple hole, rectangular pattern, bounded fillet/chamfer, feature listing, body measurement, safe save-as, STEP AP242 export, and undo.

The workflow also exposes session-state, preflight and post-mutation verification tools. See docs/architecture.md, the sample four-hole-plate.json, and the Windows scripts under scripts/.

NX 2512 validation gate

A real adapter is supported only after all checks pass on native Windows + licensed NX 2512: create a parameterized four-hole plate, inspect native feature history, change an expression and rebuild, verify body count/bounding box/volume, save-close-reopen, export STEP, and undo. Until evidence is recorded under docs/nx2512-validation.md, the default bridge fails closed.

Marketplace

DSH Desktop obtains community listings through dsh-market and the awesome-dsh-plugin catalog. See docs/marketplace.md for the release checklist and conservative submission entry. This repository must not be advertised as real NX automation until the validation gate passes.

License

MIT applies to this repository's code. Siemens NX, NXOpen libraries, documentation, licenses, and user part files are not distributed.