# CSI ETABS MCP Bridge 🏢

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![CSI ETABS](https://img.shields.io/badge/CSI-ETABS%20v19--v22-blue.svg)](https://www.csiamerica.com/products/etabs)
[![Ecosystem](https://img.shields.io/badge/AEC_MCP_Fleet-Structural_Analysis-6366f1.svg)](https://github.com/Aaradhya-Dev-Tamrakar/autodesk-mcp)

A Model Context Protocol (MCP) server that connects AI coding assistants (**Google Antigravity**, **Claude Desktop**, **Cursor**) directly with **Computers and Structures, Inc. (CSI) ETABS** for structural building analysis and seismic design.

Built for **civil/structural engineers, architectural engineering students, and BIM researchers**, enabling AI agents to programmatically query building models, define materials, generate frame geometries, execute finite-element solvers, and extract structural forces.

---

## ⚡ Key Highlights

* **Direct CSI OAPI COM Integration**: Communicates directly with the ETABS engine via Windows COM (`CSI.ETABS.API.ETABSObject` → `SapModel`).
* **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).
* **Structural Engineering Tool Suite**:
  * **Model Inspection**: Units, story levels, elevations, and object counts.
  * **Materials & Sections**: Concrete (M20–M50), structural steel, rebar grades, rectangular and circular columns/beams.
  * **Frame Generation**: Automated placement of beam/column members across story levels.
  * **Solver Execution**: Triggers ETABS finite-element analysis engine.
  * **Post-Processing & Extraction**: Joint displacements, inter-story drift ratios, modal periods, shear forces, and bending moments.

---

## 🚀 Quick Start

### 1. Installation
```powershell
git clone https://github.com/Aaradhya-Dev-Tamrakar/etabs-mcp.git
cd etabs-mcp
pip install -e .
# Install COM client library (if not already present):
pip install comtypes
```

### 2. Running the Bridge
With CSI ETABS open with a model:
```powershell
python -m etabs_mcp
```
To test connectivity:
```powershell
python -m etabs_mcp --test
```

### 3. Routing via Master Gateway
When the bridge is running, the [autodesk-mcp Gateway](https://github.com/Aaradhya-Dev-Tamrakar/autodesk-mcp) automatically detects it and routes `etabs_*` tools to your live ETABS model!

---

## 🛠️ Tool Suite

| Tool | Description |
| :--- | :--- |
| `etabs_get_model_info` | Retrieves units, story heights, and member counts from active ETABS model. |
| `etabs_define_materials_and_sections` | Defines concrete/steel materials and frame cross-sections. |
| `etabs_draw_frames` | Programmatically constructs columns and beams between coordinates. |
| `etabs_run_analysis` | Executes the finite-element analysis solver. |
| `etabs_get_results` | Extracts story drifts, displacements, or forces for a given load case. |

---

## 📄 License

MIT License © 2026 Aaradhya Dev Tamrakar