# Trimble SketchUp MCP Bridge 📐

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Ruby API](https://img.shields.io/badge/SketchUp-Ruby%20API-red.svg)](https://ruby.sketchup.com/)
[![Ecosystem](https://img.shields.io/badge/AEC_MCP_Fleet-Conceptual_Massing-6366f1.svg)](https://github.com/Aaradhya-Dev-Tamrakar/autodesk-mcp)

A Model Context Protocol (MCP) server that connects AI assistants (**Google Antigravity**, **Claude Desktop**, **Cursor**) directly with **Trimble SketchUp** for rapid architectural 3D conceptual massing, spatial planning, and solar shadow analysis.

Built for **architecture students (B.Arch), urban designers, and conceptual modelers**, enabling AI agents to programmatically query models, extrude massing floor plates, calculate shadow angles, and capture viewport renderings.

---

## ⚡ Key Highlights

* **Native Embedded Ruby Extension**: Runs directly inside SketchUp's embedded Ruby runtime with zero external dependencies.
* **Live Fleet Registration**: Automatically registers its dynamic port and PID with `%LOCALAPPDATA%\AutodeskMCP\registry.json`, enabling single-entry routing through [autodesk-mcp](https://github.com/Aaradhya-Dev-Tamrakar/autodesk-mcp).
* **Architectural Massing Tool Suite**:
  * **Model Inspection**: Entities count, layers/tags, component definitions, and shadow settings.
  * **3D Massing Extrusion**: Generate building footprints from coordinate polygons and push/pull into massing volumes.
  * **Solar & Shadow Studies**: Set date, solar time of day, and toggle shadows for daylight analysis.
  * **Viewport Capture**: Export shaded viewport images as base64 JPEG.

---

## 🚀 Quick Start

### 1. Installation
Run the automated installer:
```powershell
.\install.ps1
```
This deploys `sketchup_mcp.rb` and `sketchup_mcp/` to:
`%APPDATA%\SketchUp\SketchUp <Year>\SketchUp\Plugins\`

### 2. Auto-Startup
The bridge server starts automatically in a background Ruby thread whenever Trimble SketchUp is opened.

### 3. Routing via Master Gateway
When running, the [autodesk-mcp Gateway](https://github.com/Aaradhya-Dev-Tamrakar/autodesk-mcp) auto-detects SketchUp and routes `sketchup_*` tools seamlessly.

---

## 🛠️ Tool Suite

| Tool | Description |
| :--- | :--- |
| `sketchup_get_model_info` | Retrieves active model entities, layers, and shadow settings. |
| `sketchup_create_massing` | Extrudes architectural massing volume from polygon footprint. |
| `sketchup_set_shadows` | Configures shadow display and solar hour for sun path analysis. |
| `sketchup_capture_viewport` | Captures shaded viewport image as base64. |

---

## 📄 License

MIT License &copy; 2026 Aaradhya Dev Tamrakar