استخدم خط أنابيب التصميم NexyFab (نص→2D→3D LOD→تعديلات لكل جزء) عبر HTTP API وMCP (Claude وعملاء ذكاء اصطناعي آخرون) وCLI. الذكاء الاصطناعي يفسر فقط؛ الهندسة والتحقق (المفردات، التداخل، الدعم، البوابات الهيكلية) تعمل على محرك حتمي. جميع المخرجات غير قانونية.
أنشئ مفتاحًا، وعرض مفاتيحك، وألغِ فورًا أدناه. يخزن الخادم فقط تجزئة sha256 + بادئة عرض قصيرة؛ يتم عرض المفتاح بنص واضح مرة واحدة بالضبط عند الإنشاء — احفظه في مدير كلمات المرور أو سر CI. إذا فُقد، أصدر مفتاحًا جديدًا وألغِ القديم.
نقاط النهاية الأساسية (كلها POST · JSON). مرر كائن assembly من الاستجابة إلى المكالمة التالية لسلسلة التعديلات؛ يتراكم سجل REV تلقائيًا.
| Endpoint | ماذا يفعل |
|---|---|
| /api/nexyfab/drawing/assemble | نص → تجميع متعدد الأجزاء (+مسودة LOD) |
| /api/nexyfab/drawing/compose | نص → جزء واحد |
| /api/nexyfab/drawing/edit-part | 🎯 تحرير جزء واحد فقط بالذكاء الاصطناعي |
| /api/nexyfab/drawing/face-drag | سحب/دفع الوجه / تعيين البعد (حتمي) |
| /api/nexyfab/drawing/part-op | تكرار · حذف · نقل · شطب |
| /api/nexyfab/drawing/export-step | تصدير STEP B-rep |
| /api/nexyfab/drawing/package | حزمة التسليم |
# Common: send the nf_live_ key as a Bearer token. Responses use {"ok":true, "assembly":{…}, …}.
KEY=nf_live_XXXX ; BASE=https://nexyfab.com/api/nexyfab/drawing
# 1) Create { description } -> { ok, assembly, openscad?, parts?, interferences?, gateErrors? }
curl -s "$BASE/assemble/" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"description":"two cylindrical columns, diameter 200 and height 400, on a 1000x800x20 base plate"}' > r1.json
# 2) AI-edit one part { assembly, partId, instruction } -> { ok, assembly, patch, note, interferences, massKg }
curl -s "$BASE/edit-part/" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d "{\"assembly\": $(jq .assembly r1.json), \"partId\":\"column_1\", \"instruction\":\"set height to 600\"}"
# 3) Set face dimensions directly (deterministic · no AI) face: x±/y±/z± (box) · axis±/radial (revolved)
curl -s "$BASE/face-drag/" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"assembly": {…}, "partId":"column_1", "face":"axis+", "targetMm":600}'
# 4) Batch part operations (deterministic) op: delete|duplicate|translate|fillet · partIds[] · opts
curl -s "$BASE/part-op/" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"assembly": {…}, "op":"duplicate", "partIds":["column_1"], "opts":{"offset":[300,0,0]}}'
# 5) Deliverable document set { assembly, options? } -> { ok, files, structural, interferences, welds }
curl -s "$BASE/package/" \
-H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
-d '{"assembly": {…}, "options":{"title":"column assembly","withStep":true}}'واجهة برمجة تطبيقات الحسابات الهندسية (الكمرات، اللحامات، البراغي، إلخ) مُتحكم بها بشكل منفصل وتُرجع الصيغ/القيم الوسيطة؛ وتستخدم نفس مفتاح Bearer الخاص بواجهة الهندسة.
يعمل خادم MCP البعيد أحادي الملف والخالي من التبعيات على Node 18 أو أحدث، ويعرض 15 أداة بالضبط في tools/list: design_assembly · compose_part · edit_part · face_drag · part_op · domain_design · analyze_fea · reconstruct_verify · reconstruct_fleet · code_check · verify_domain · interior_check · landscape_check · bridge_check · load_path. تعمل بعض أدوات التحقق من دون مفتاح؛ أما أدوات الإنشاء/التحرير وFEA والهندسة العكسية فتتطلب مفتاح Pro API. يُعد MCP المحلي في المستودع (scripts/drawing-to-3d/mcp-server.mjs) سطح منتج منفصلًا يعرض 92 أداة، بينها عمليات محلية فقط وأخرى بعيدة فقط؛ استخدم tools/list لكل خادم بوصفه المرجع المعتمد للأسماء والمخططات.
# 1) Download the MCP server
curl -sL https://nexyfab.com/downloads/nexyfab-mcp.mjs -o ~/nexyfab-mcp.mjs
# 2) Register with Claude Code (issue the API key in panel 0 above; absolute path required)
claude mcp add nexyfab -e NEXYFAB_API_KEY=nf_live_XXXX -- node /absolute/path/nexyfab-mcp.mjs
# 3) Verify registration
claude mcp list
# 4) Then ask Claude in natural language:
# "Build an assembly with two columns on a 1000x800 base using nexyfab, then set column_1 height to 600"⚠ صيغة -e مريحة ولكنها تترك المفتاح في سجل الصدفة. على الأجهزة المشتركة، امسح السجل بعد التسجيل أو قم بتدوير المفتاح (قم بإبطاله وإعادة إصداره فورًا في اللوحة 0 أعلاه). إذا فشل التسجيل، اشتبه في المسار أولاً — ~ لا يتم توسيعه في بعض البيئات.
بالنسبة لـ Claude Desktop، أضف نفس الشيء تحت mcpServers في claude_desktop_config.json: {"command":"node","args":["/absolute/path/nexyfab-mcp.mjs"],"env":{"NEXYFAB_API_KEY":"nf_live_XXXX"}}.
أربع قدرات صلبة جديدة (بما يعادل الويب): analyze_fea (تحليل عناصر محدود سريع — ثابت خطي هيكلي فقط من scad+مادة+حمل؛ الحراري/الوضعي/الحراري المرن غير متاح عبر هذه الأداة) · reconstruct_verify (هندسة عكسية مُتحقق منها — STL/STEP/DWG/SAT مقابل بوابة إعادة بناء على bbox/genus/watertight) · reconstruct_fleet (أسطول إعادة بناء بالذكاء الاصطناعي — SCAD بارامتري متعدد النماذج، Pro + ميزانية) · code_check (فحص الكود/تدقيق يستشهد بـ PASS/FAIL/NA ضد القوانين العامة). الثلاثة الأولى عن بُعد فقط (تتطلب NEXYFAB_API_KEY — تستخدم OpenSCAD/gmsh/OCCT/LLM مستضافة؛ رفض صريح بدون مفتاح)؛ code_check يعمل محليًا دون اتصال (مجموعة قواعد حتمية بحتة). جميعها غير قانونية (فحص بمستوى هندسي / مساعدة مراجعة حتمية — التحليل التفصيلي والمراجعة القانونية تظل واجبًا على محترف مرخص).
خمس سلاسل تحقق تخصصية (بما يعادل الويب · مسارات عامة — تعمل بدون مفتاح API): verify_domain (حاسبات هندسية في 5 تخصصات — مقطع/امتداد مشتق من الهندسة + أحمال/مواد المستخدم، مع بنود مقتبسة) · interior_check (مسافة إخلاء BFS + إشغال + تشطيبات) · landscape_check (أعضاء خشبية + انقلاب بسبب الرياح) · bridge_check (توزيع تلقائي للجسر/القوس/الجمالون/المثبت بالكوابل/المعلق/السلالم) · load_path (مسار الحمل من البلاطة->الكمرة->العمود->الأساس). كلها حتمية — لا تختلق الأحمال أبدًا (needInputs عند النقص). غير قانونية (المهندس/المعماري المرخص يظل مسؤولاً).
يوفر scripts/drawing-to-3d/cli.mjs نفس سطح الأدوات في سطر الأوامر (محرك محلي عندما يكون لديك المستودع). مع تعيين NEXYFAB_API_KEY، تستدعي أدوات التوليد/التحرير الخمس واجهة برمجة التطبيقات المستضافة (الوضع البعيد). الإخراج عبر الأنبوب = JSON نقي؛ TTY يضيف سطر ملخص.
cd scripts/drawing-to-3d # local engine when the repository is available
export NEXYFAB_API_KEY=nf_live_XXXX # with a key, five create/edit commands use hosted API; unset = local
node cli.mjs assemble "two columns on a 1000x800x20 base plate" --out asm.json # text → assembly
node cli.mjs build asm.json # deterministic rebuild and gate summary
node cli.mjs edit-part asm.json column_1 "set height to 600" --out asm.json # AI part edit
node cli.mjs face-drag asm.json column_1 --face axis+ --target 600 --out asm.json # face dimension (deterministic)
node cli.mjs part-op asm.json --op duplicate --ids column_1 --offset 300,0,0 --out asm.json
node cli.mjs step asm.json --out model.step # B-rep STEP export
node cli.mjs preview asm.json --out ./png --views iso,side,top # headless render → PNG
node cli.mjs package asm.json --out ./docs --step # GA · parts · BOQ · spec · DXF · STEP
node cli.mjs domain civil "retaining wall H=3m length 200m" --out pkg.json # multi-domain (remote only — key required)
node cli.mjs templates bridge # list domain templates
node cli.mjs fea asm.json --load 500 --material steel # quick FEA (remote — hosted OpenSCAD/gmsh)
node cli.mjs reconstruct part.stl # verified reverse engineering (remote — reconstruction gate)
node cli.mjs fleet part.stl # AI reconstruction fleet (remote + Pro/budget)
node cli.mjs codecheck features.json # code-check/audit 41 rules (local/offline/keyless)
node cli.mjs interior asm.json # interior egress/finishes chain (local)
node cli.mjs landscape asm.json # landscape timber/wind-load (local)
node cli.mjs bridge asm.json # bridge review (meta auto-dispatch/local)
node cli.mjs loadpath asm.json # building load-path chain (local) | --list use table
node cli.mjs list # list all tools and commandsالإخراج عبر الأنبوب هو JSON نقي (قابل للتحليل آليًا)؛ TTY يضيف سطر ملخص قبول/رفض (فرض النقاء باستخدام --raw). الأوامر الإضافية (loft, constraints, dossier, domain) موثقة في رأس cli.mjs ومخرجات list.
تتبع استدعاءات توليد الذكاء الاصطناعي فتحات الخطة وميزانيات التكلفة اليومية (face-drag/part-op الحتمية لا تستهلك فتحات). عندما ترفض بوابة، نعيد 422 مع السبب بدلاً من تغيير الهندسة بصمت.