LazerMCP

Payas STEM lazer kesim MCP sunucusu. Python Boxes.py’yi çağırır; kaynağını modele dökmez, SVG’yi elle yazdırmaz.

Bu sunucu bir takım çantasıdır, ürün kataloğu değil. Gelen AI (ChatGPT / Claude) fotoğrafa bakar, plan_laser_job çağırır, create_design ile primitive’lerden kesimi besteler. Her maket için yeni create_* aracı eklenmez.

Claude / ChatGPT connector adresi kök / değil, /mcp yoludur.

Temel kural

Çalışan kod ≠ doğru ürün.
Oluşmuş SVG ≠ üretilebilir ürün.
Güzel önizleme ≠ monte edilebilir ürün.

Yazılım fiziksel testi yapamaz. Dijital PASS + fiziksel NOT VERIFIED → prototip SVG. Üretim export’u yazılım asla açmaz.

Gelen AI speak kartını aynen yapıştırır:

FINAL STATUS: PROTOTYPE READY

Digital Geometry        PASS
Part Completeness       PASS
Connections             PASS
Assembly                PASS
Collision               PASS
Kinematics              PASS
SVG Geometry            PASS
Manufacturing Geometry  PASS

Physical Kerf Test      NOT VERIFIED
Physical Assembly       NOT VERIFIED
Movement Test           NOT VERIFIED
After Assembly Use      NOT VERIFIED

AUTHORIZED OUTPUT:
Prototype SVG

PRODUCTION EXPORT:
BLOCKED

Yazılım fiziksel satırı uydurmaz. İnsan 100 mm çubuğu ölçüp measured_bar_mm verir; kerf PASS olabilir. physical_assembly=verified, movement_test=verified ve use_test=verified yalnız gerçek denemeden sonra. Hepsi (yoksa N/A) PASS ise PRODUCTION READY ve PRODUCTION EXPORT: AUTHORIZED. LED/şalter çalışmasını yazılım uydurmaz. Uydurma flag = FAIL.

error / errors dönülmez. Öğretme look_again ve speak ile yapılır.

Related MCP server: openscad-mcp

İş hattı

Fotoğraf / istek
    → plan_laser_job
    → create_design
         Designer → Reviewer → Repair → Reviewer → Final Gate → SVG

Bu döngü create_design içinde çalışır. Gelen AI adımı atlayamaz; review için ayrı araç istemez.

1. Fotoğrafa bak. Parçaları what_you_see ile anlat.

2. plan_laser_job — dilbilgisi, ölçek, next_tool.

3. create_design — Boxes.py rectangularWall / FingerJoint / kontur. Ölçek: parameters.reference = {feature, mm, drawn_mm}.

4. Reviewer parça haritası (P01…), bağlantı grafiği (C01…), PASS / WARNING / FAIL / NOT_VERIFIED üretir.

5. Repair minimum parametrik düzeltir (çatı kilidi, eksik gable, koaksiyel mil, tab-slot kalınlığı). Ürünü sıfırdan yazmaz.

6. Final Gate speak kartını üretir. Dijital PASS olsa bile yetkili çıktı yalnızca Prototype SVG’dir; PRODUCTION EXPORT BLOCKED kalır.

2D sanat (logo, siluet, yapboz kazıması) için create_from_reference. Duvar / çatı / pervane için değil.

Primitive’ler

create_design primitives listesi alır. Kapı / pencere ayrı parça değildir; ön duvara slot kesilir.

Opsiyonel işaret (parça üzerine gravür / kesim). Ayrı parça değildir. part.markings veya {type:marking, target_part}:

İkonlar: plus, arrow, star, heart, circle, x, square, triangle. Metin outline path (Arimo). Logo için d (SVG path) veya points.

Kenarlar: rectangularWall sırası alt, sağ, üst, sol. e düz, f erkek parmak, F dişi parmak deliği. Parmak geometrisini uydurma; Boxes.py FingerJoint üretir.

Ölçek: kullanıcı cm/mm verdiyse o ayaktır. Vermediyse fotoğraftan tek uzunluk seç, parameters.reference = {feature, mm, drawn_mm} geç. İkinci ölçü uydurma.

MCP araçları

Tercih edilen:

Plan söylemedikçe: generate_svg, get_generator_schema.

İsimli kitler yalnız mevcut Payas ürünleridir:

• create_traffic_light

• create_robot_bank

• create_drawing_robot

• create_product_box

• create_yacht

• create_astronaut

Yeni değirmen / ev / puzzle için kit isteme.

Payas varsayılanları

• Malzeme: 3 mm kavak kontrplak

• Kerf / burn kilitli: 0.15 mm

• Tabla: 1500 × 3000 mm

• Çıktı: SVG + DXF (file_id, svg_url, dxf_url) + otomatik nest önizlemesi

• Malzeme / makine: parameters.material (poplar_3mm, poplar_4mm, mdf_3mm, acrylic_3mm), parameters.machine (payas_workshop, desktop_400, lasercad_900)

• Kerf: insan measured_bar_mm verir; kalibrasyon makine+malzeme için saklanır. Kerf uydurma.

• BOM: kit veya bestelenmiş işte malzeme listesini MCP yazar (bom, MATERIALS (MCP)). Donanımı uydurma.

• Proje: parameters.project ile sürüm geçmişi. Studio: /dashboard

• Kesim #FF0000, kazıma #000000, LaserCAD Y-up

• Kapalı kesimlerde ~1 mm tutucu nick (parça düşmesin)

• Nesting yalnız öteleme (döndürme / ayna yok)

• Yazılar outline path (paketlenmiş Arimo). SVG <text> yok.

Paketler (fiyat landing’de yok; beta açık): Free 10 tasarım/ay · SVG · standart profil. Maker SVG+DXF · özel malzeme/makine · fotoğraf → tasarım · gelişmiş doğrulama. Pro BOM · gelişmiş nesting · proje geçmişi · API · ticari kullanım. LASERMCP_BETA=1 (varsayılan) kotayı kaldırır, özellikleri açık tutar.

Kurulum

Python 3.12+ (geliştirme 3.14 ile de çalışır). Boxes.py BOXES_PATH veya vendor/boxes-master.

cd C:\Project\boxes-mcp
python -m venv .venv
.\.venv\Scripts\pip.exe install -r requirements.txt
.\.venv\Scripts\python.exe server.py

Tarayıcı landing: http://127.0.0.1:8000 · stüdyo: /dashboard Cursor MCP: http://127.0.0.1:8000/mcp

Ortam değişkenleri

Hepsi isteğe bağlıdır.

Vercel

server.py top-level ASGI app export eder. Boxes.py vendor/boxes-master ile gelir.

Hobby yeter. Push sonrası isteğe bağlı MCP_PUBLIC_BASE_URL. Deployment Protection kapalı olsun; aksi halde Claude connector 401 alır.

SVG Vercel’de /tmp altındadır (geçici). Canlı connector’ın yeni kodu görmesi için deploy gerekir; ChatGPT/Claude oturumunu yeniden bağla.

Sağlık

GET /health Boxes.py importunu ve generator kataloğunu doğrular.

Ne yapılmaz

• SVG / DXF elle yazmak

• Geometriyi çevirmek, döndürmek, aynamak

• Parmak eklemini uydurmak (Boxes.py FingerJoint kullan)

• Kapı / pencereyi kayan ayrı parça yapmak

• Pervane yerine disc kullanmak

• Her işe kupon eklemek

• LAZER KESİME HAZIR veya üretim export’u yetkili demek (insan ölçüsü / montajı olmadan)

• measured_bar_mm veya physical_assembly uydurmak

• Kerf veya vida/LED/motor listesini uydurmak (MCP bom yazar)

• Her yeni maket için yeni MCP aracı istemek