dsh-solidworks
Health Uyari
- License — License: AGPL-3.0
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Gecti
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Gecti
- Permissions — No dangerous permissions requested
Bu listing icin henuz AI raporu yok.
DeepSeek Harness 的 SolidWorks MCP 集成(自本机仓库同步)
dsh-solidworks
dsh-solidworks is an enterprise-grade AI CAD plugin designed for DeepSeek Harness (DSH) and standard MCP clients that bridges conversational AI directly to your local SolidWorks desktop session. Control SolidWorks using intuitive natural language, automate 3D parametric modeling, execute safe dimension adjustments, and enjoy atomic transaction rollbacks for risk-free CAD workflows.
- Plugin Package:
dsh-solidworks— AGPL-3.0-only - Execution Engine:
solidworks-automation-skillPython MCP server (MIT, vendored undervendor/, seeNOTICE) - Chinese Documentation (中文文档): 详细中文技术文档与极简指南参见 README.zh.md。
⚡ Key Highlights
- Zero-Friction Automated Lifecycle: One-click setup (
npm run setup), comprehensive diagnostics (npm run doctor), safe upgrade with auto-backups (npm run upgrade), and non-destructive uninstaller (npm run uninstall). - Natural Language CAD: Tell the AI what you want in plain words; it plans feature graphs, builds parametric geometry, and drives SolidWorks in real-time.
- Fail-Safe Shadow Backup: Every geometric modification is safeguarded by atomic shadow backups. If an operation fails or causes a rebuild error, your model is losslessly restored in sub-second time.
- Double-Precision Physical Verification: Geometry/volume checks verified in pre-expiration SolidWorks 2026 baseline runs (
<= 0.0003 mm³/<= 4.7e-4relative delta across27/71covered tools); post-unification live SW re-run is currently blocked by local Student Edition expiration (L5-BLOCK-01). - Zero-Trust Policy Gate: Three runtime policy tiers (
read-only,standard,full) with strict path confinement, host-nativectx.approvalinteractive human authorization (solidworks_confirmself-approval is disabled /SELF_APPROVAL_PROHIBITED), andSW_LOCK_WAIT_TIMEOUT_SECONDSfast-fail isolation against modal/Head-of-Line stalls.
🚀 Quick Start (Zero-Configuration Installation)
No manual Python path tuning, environment variable editing, or manual DLL registration is required.
1. Prerequisites
- Operating System: Windows 10/11 x64
- SolidWorks: Desktop versions 2020–2026 (activated and launched at least once)
- Node.js: v22.12+ (
engines.node >=22.12) - Python: 3.10+ x64 (installed on your system)
2. One-Click Setup
Open your terminal in the plugin directory and run:
npm run setup
The setup script automatically:
- Detects system Node.js and Python 3.10+ environments.
- Creates an isolated local virtual environment (
.venv). - Installs all required packages (
mcp,pydantic,pywin32,comtypes, etc.) silently with idempotency. - Invokes
pywin32_postinstall.pyto register SolidWorks COM automation interfaces. - Registers the plugin into your active DSH profile via
dsh_adapter.js(to emit a standalone direct MCP client config only when explicitly needed, runnode scripts/generate_mcp_config.js --write-direct-config).
3. Run System Doctor
Verify your environment at any time using the 12-dimensional health check:
npm run doctor
All checks will report green [✔ PASS] when your machine is ready to drive SolidWorks.
🔌 Connecting to DeepSeek Harness (DSH)
Generate Configuration Automatically
To seamlessly hook this plugin into your DeepSeek Harness or any standard MCP client, run:
npm run mcp-config
This outputs a validated MCP configuration block tailored to your local environment.
Standard MCP Client JSON Configuration Example
For standalone MCP hosts (such as Claude Desktop or custom agents):
{
"mcpServers": {
"solidworks-cad": {
"command": "C:\\Users\\User\\dsh-solidworks-plugin\\.venv\\Scripts\\python.exe",
"args": [
"C:\\Users\\User\\dsh-solidworks-plugin\\vendor\\solidworks-automation-skill\\mcp-server\\server.py"
],
"env": {
"DSH_ALLOWED_ROOTS": "[\"C:\\\\Users\\\\User\\\\Documents\\\\SolidWorks_Models\"]",
"PYTHONUNBUFFERED": "1"
}
}
}
}
🛠 Command Summary
| Command | Description |
|---|---|
npm run setup |
Automatically configure virtual environment & register COM |
npm run setup -- --optional |
Install optional DFM manufacturing & Office report extensions |
npm run doctor |
Run comprehensive 12-point system diagnostic |
npm run upgrade |
Auto-backup existing configs and perform safe incremental upgrade |
npm run uninstall -- --dry-run |
Preview safe cleanup targets (never touches your CAD assets) |
npm run uninstall -- --yes |
Perform non-destructive cleanup of plugin runtimes |
npm test |
Run core offline test suite (85 assertions across 4 offline suites; npm run test:all: 201 assertions across 20 suites including 42 Python suites) |
📚 Documentation Index
- 📖 User Guide (普通用户指南): Step-by-step setup and conversational CAD examples.
- 🛠 Troubleshooting Guide (排障手册): Practical solutions for COM permissions, dialog blocking, and network mirrors.
- 📊 Feature Matrix (功能支持矩阵): Detailed maturity roadmap across all 13 CAD features, assemblies, and drawings.
- 📝 Changelog (版本变更日志): Milestone records and historical evolution.
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi