fusion360-mcp

Fusion 360 API over MCP protocol — Bertalanffy Labs

Autodesk Fusion 360'ı herhangi bir MCP-uyumlu AI client'tan (Claude Code, Cursor, Codex) doğal dille kontrol edin.

Any MCP Client ──(stdio/JSON-RPC)──► MCP Server ──(TCP :9876)──► Add-in ──(CustomEvent)──► Fusion Main Thread
     Claude Code                   fusion360_mcp               Fusion 360 API

Ön Koşullar

Related MCP server: Fusion Agent Harness MCP Server

Kurulum

1. Python paketini kur

git clone https://github.com/iamtechnoana/fusion360-mcp
cd fusion360-mcp
pip install -e ".[dev]"

2. Ortam değişkenlerini ayarla

cp .env.example .env
# .env dosyasını düzenle (varsayılanlar genellikle yeterli)

3. Fusion 360 add-in'i kur

addin/fusion360_mcp_bridge/ klasörünü kopyala:

Windows: %APPDATA%\Autodesk\Autodesk Fusion 360\API\AddIns\
macOS:   ~/Library/Application Support/Autodesk/Autodesk Fusion 360/API/AddIns/

Fusion 360 → Tools → Add-Ins → Add-Ins (Shift+S) → fusion360_mcp_bridge → Run

Ekranda "Fusion MCP bridge started — listening on port 9876" görünmeli.

4. Claude Code'a bağla

claude mcp add fusion360 --scope project -- python -m fusion360_mcp.server

ya da .mcp.json dosyası proje kökünde hazır — Claude Code otomatik algılar.

İlk Test

# Add-in çalışıyor mu?
python -c "
import socket, json
s = socket.create_connection(('127.0.0.1', 9876), timeout=3)
s.sendall(b'{\"tool\":\"list_parameters\",\"args\":{}}\n')
import time; time.sleep(0.5)
print(s.recv(1024).decode())
s.close()
"

Beklenen çıktı: {"success": true, "message": "0 parameters found", "data": {}}

Tool Listesi

Tam dokümantasyon: docs/tools/

Batch Export (Parametrik Varyant Üretimi)

from fusion360_mcp.pipeline import generate_variants, VariantSpec
from fusion360_mcp.fusion.client import FusionClient

client = FusionClient("127.0.0.1", 9876, timeout=30)
variants = [
    VariantSpec({"outer_diameter": d}, f"exports/flange_OD{d}.step")
    for d in [40, 50, 60, 70, 80]
]
report = await generate_variants(client, variants)
print(report.summary())

Bilinen Kısıtlar

• Fusion iç birimi CM — tüm kullanıcı değerleri mm, dönüşüm add-in içinde otomatik

• Tool'lar sıralı çalışır — MCP client tarafında Fusion çağrıları serialize edilir; her tool call ayrı TCP bağlantısı

• 30 saniyelik timeout — karmaşık CAM operasyonları aşabilir

• Main thread zorunlu — Fusion API worker thread'den çağrılamaz (CustomEvent mimarisi bu yüzden)

• runOnStartup: false — Fusion her açılışta add-in'i manuel başlatmayı gerektirir

Detaylar: docs/known-issues.md

Geliştirme

python -m pytest tests/ -v          # Fusion olmadan çalışır
python -m fusion360_mcp.server      # MCP server başlat

Katkı & Lisans

Katkı rehberi: CONTRIBUTING.md
Güvenlik bildirimi: SECURITY.md

Nguồn Tham Khảo & Ghi Nhận (Credits & Attribution)

Dự án này được phát triển, nâng cấp bảo mật và tối ưu hóa tính ổn định dựa trên mã nguồn gốc của:

• Tác giả gốc: iamtechnoana / Bertalanffy Labs

• Kho lưu trữ gốc: iamtechnoana/fusion360-mcp

Các cải tiến & bản vá trong phiên bản nâng cấp này:

1. Bảo mật: Khắc phục lỗ hổng Path Traversal (_validate_export_path), giới hạn payload TCP (64 KB), danh sách trắng đơn vị đo lường (unit whitelist) cho parameters.

2. Độ ổn định: Sửa lỗi UnboundLocalError trong event handler CustomEvent, bắt lỗi OSError trong vòng lặp TCP server, kẹp giá trị timeout tối thiểu (req_timeout).

3. Tính năng mới: Bổ sung công cụ kiểm tra sức khỏe hệ thống f360_ping và cơ chế hoàn tác tham số giao dịch tự động SnapshotGuard (theo ADR-0004).

4. Tương thích MCP: Khóa phiên bản MCP SDK <2 và cấu hình sẵn sàng cho Claude Desktop, Cursor, và Codex.

Lisans

MIT — Bertalanffy Labs © 2026 / Upgraded & Enhanced Edition