structural-mcp-servers

HuVelasco/structural-mcp-servers

3.2

If you are the rightful owner of structural-mcp-servers and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Structural MCP Servers are designed for automating structural engineering tasks using software like ETABS, Revit, and Tekla. These servers provide a comprehensive suite of tools to streamline and enhance the efficiency of structural design and analysis processes.

Tools
1
Resources
0
Prompts
0

<� Structural MCP Servers

MCP servers for structural engineering automation (ETABS, Revit, Tekla)

Assessment

=� Quick Start

ETABS MCP Server (Production Ready)

The flagship server with 30+ tools for structural engineering automation.

# Navigate to production folder
cd servers/etabs_mcp/PRODUCTION

# Install dependencies
pip install -r requirements.txt

# Run the server
python server.py

Key Features:

  •  Table Extraction: Access all 806 ETABS tables
  •  Building Templates: Steel deck, concrete frame, wall models
  •  Element Tools: Create/modify any structural element
  •  Health Reports: Model validation with 3D visualization
  •  Safety Systems: User permissions and MCP prompts
  •  Design Tools: Steel member design with AISC codes

=� Repository Structure

structural-mcp-servers/
�� servers/
   �� etabs_mcp/                    # <� Main ETABS MCP Server
       �� PRODUCTION/               # Production-ready deployment
       �� 007-v0.7-model-health-reports/  # Latest stable version
       �� docs/                     # Comprehensive documentation
          �� ETABS_MCP_ASSESSMENT_REPORT.md  # Full assessment
       �� tests/                    # Jupyter notebooks and testing
�� Documentation/                    # High-level documentation
�� shared/                          # Shared utilities (future)
�� config/                          # Global configuration

=' ETABS MCP Server Details

Current Capabilities (v0.7)

  • Connection Management: Stable COM-based ETABS integration
  • Model Creation: 3 building template types with customizable parameters
  • Element Operations: Universal element creation/modification tools
  • Analysis & Design: Complete structural analysis and steel design workflows
  • Data Extraction: Revolutionary table extraction accessing all ETABS data
  • Health Reporting: Comprehensive model validation with interactive 3D visualization
  • Safety Features: Role-based permissions and structured MCP prompts

Technical Highlights

# Revolutionary discovery: Access ALL ETABS tables with one function
def etabs_extract(model, table_name):
    ret = model.DatabaseTables.GetTableForDisplayCSVString(table_name, [], "")
    if len(ret) >= 3 and ret[2]:
        return pd.read_csv(StringIO(ret[2]))
    return None

# Works with all 806+ ETABS tables:
joints_df = etabs_extract(model, "Objects and Elements - Joints")
forces_df = etabs_extract(model, "Element Forces - Frames")
design_df = etabs_extract(model, "Steel Frame Design Summary - AISC 360-16")

Architecture

  • FastMCP Framework: Modern MCP server implementation
  • Modular Design: Clean separation in /tools folder structure
  • Version Control: Excellent chronological development (v0.1 to v0.7)
  • Safety First: User permissions and structured prompts for critical operations
  • Production Ready: Comprehensive error handling and logging

=� Development Timeline

One Week Achievement (Remarkable Progress):

  1.  Solid Foundation: COM connection that actually works
  2.  Table Breakthrough: Access to ALL ETABS data (huge discovery)
  3.  Modular Architecture: Clean, extensible design
  4.  30+ Working Tools: Comprehensive MCP integration
  5.  Safety Systems: Permissions and structured prompts
  6.  Documentation: Comprehensive assessment and testing

Assessment Score: 8.5/10 - Exceptional foundation built in one week

<� Next Development Phase

Based on the , the recommendation is HYBRID approach - build on the excellent v0.7 foundation with strategic enhancements.

Week 2 Focus Areas:

  • =' Fix load application consistency (1-2 days)
  • =� Enhanced design result extraction (1-2 days)
  • � Automated ASCE 7 load combinations (2-3 days)

  • � Integration testing and polish (1-2 days)

=� Documentation

  • - Comprehensive analysis and recommendations
  • - Complete API reference
  • - Interactive API testing and examples

> Contributing

This project follows Hugo's ADHD-friendly development approach:

  • Baby Steps: Small, focused increments
  • Version Control: Chronological folder naming (NNN-vX.X-description)
  • Working Code First: Function over perfection
  • Clear Documentation: Every decision explained

=� Contact

  • Author: Hugo Velasco (Uncle[H])
  • Focus: Structural engineering automation that actually works
  • Philosophy: Simple solutions that solve real problems

The hardest problems are solved. Now it's time to build the features that make this truly powerful. =�