# Expolinc Booth Designer

**AI-driven trade fair booth design for Expolinc modular exhibition systems, powered by FreeCAD + MCP.**

Design complete trade fair booths using Expolinc Classic Frame and Light Frame components — via natural language commands through an AI assistant (Claude, etc.). Generate 3D models, technical drawings, and bill of materials from simple descriptions like *"a 4x3m island booth with backlit walls and storage room."*

## Features

- **Parametric Expolinc component library** — Classic Frame profiles, Light Frame backlit modules, connectors, storage rooms, doors, and accessories as parametric FreeCAD objects
- **MCP server integration** — Extends the [sergiudanstan/freecad-mcp](https://github.com/sergiudanstan/freecad-mcp) server with 12 Expolinc-specific tools
- **Layout engine** — Supports inline, corner, peninsula, island, and custom booth configurations
- **Bill of materials** — Component count, dimensions, weights, part numbers, recommended transport cases
- **Technical drawings** — Dimensioned multi-view drawings via FreeCAD TechDraw
- **CAD export** — STEP, STL, OBJ, DXF for manufacturing handoff

## Systems Supported

| System | Description | Sizes |
|---|---|---|
| **Classic Frame** | Modular aluminum frame with SEG fabric graphics, tool-less magnetic assembly | Widths: 500–4950mm, Heights: 2500/3000mm |
| **Light Frame** | Backlit LED frame system, integrates with Classic Frame | Same sizes + LED temperature/brightness config |
| **Connectors** | 90° corner, 180° inline, T-connector | — |
| **Accessories** | Storage rooms, doors, shelves, bridge connectors, support feet | — |

## Quick Start

```bash
# 1. Install FreeCAD 1.0+ from freecad.org
# 2. Clone the repository
git clone https://github.com/your-org/expolinc-booth-designer
cd expolinc-booth-designer

# 3. Install component library
cp -r ExpolincLib /path/to/FreeCAD/Mod/

# 4. Install MCP server
npm install
npm run build

# 5. Add to your AI assistant's MCP configuration
# See docs/INSTALL.md for details
```

## Project Structure

```
expolinc-booth-designer/
├── ExpolincLib/                  # FreeCAD Python component library
│   ├── __init__.py
│   ├── classic_frame.py          # Classic Frame parametric components
│   ├── light_frame.py            # Light Frame parametric components
│   ├── connectors.py             # Corner and inline connectors
│   ├── accessories.py            # Storage rooms, doors, shelves
│   ├── layouts.py                # Booth layout generators
│   ├── bom.py                    # Bill of materials generator
│   └── specs.py                  # Expolinc official specifications
├── mcp-server/                   # FreeCAD MCP server extension
│   ├── src/
│   │   ├── server.ts             # MCP server entry point
│   │   ├── expolinc_tools.ts     # Expolinc-specific MCP tools
│   │   ├── layout_engine.ts      # Booth layout logic
│   │   └── bom_generator.ts      # BOM generation logic
│   └── package.json
├── docs/
│   ├── ARCHITECTURE.md           # System architecture
│   ├── INSTALL.md                # Installation guide
│   ├── COMPONENT_LIBRARY.md      # Component library reference
│   ├── MCP_TOOLS.md              # MCP tools reference
│   ├── BOOTH_LAYOUTS.md          # Booth layout patterns
│   └── BILL_OF_MATERIALS.md      # BOM output guide
└── README.md
```

## License

MIT