What is Tekla Mcp Server

tekla_mcp_server is an MCP server designed to facilitate interaction with Tekla Structures, enabling users to accelerate their modeling processes and automate workflows.

Use cases

Use cases include automating the insertion of components in structural models, managing and selecting specific elements efficiently, and converting parts within Tekla Structures for better project management.

How to use

To use tekla_mcp_server, users need to install and configure an MCP client, such as chatmcp or DeepChat. After setup, users can utilize various tools provided by the server for efficient modeling.

Key features

Key features include inserting/removing Lifting Anchor (80) components, inserting custom components, selecting elements based on type or Tekla class, selecting assemblies, displaying temporary names for selected elements, and converting cut parts into real parts.

Where to use

tekla_mcp_server is primarily used in the construction and engineering sectors, particularly where Tekla Structures is employed for modeling and design.

Tekla-MCP-Server

This server facilitates interaction with Tekla Structures, helping users speed up modeling processes. It acts as a bridge between users and Tekla, enabling automated workflows and improving efficiency.

To use this server, users must first install and configure an MCP client.

Verified to work correctly with chatmcp and DeepChat clients.

Features

• Insert/remove Lifting Anchor (80) Tekla component
• Insert custom components
• Selection of specified elements based on their type or Tekla class and name
• Selection of assemblies the specified elements belong to
• Showing of temporary names for selected elements in the model
• Converting cut parts into real parts

Tools

The server provides the following tools:

• put_wall_lifting_anchors: Insert Lifting Anchor (80) Tekla components in the selected elements
• remove_wall_lifting_anchors: Remove Lifting Anchor (80) Tekla components from the selected elements
• put_custom_detail_components: Insert custom detail components with specified name to the selected elements
• select_elements: Select elements in Tekla model based on their type or Tekla class and name
• select_elements_assemblies: Get assemblies for the elements selected in Tekla model and select them
• draw_elements_names: Draw the temporary names for the selected elements in Tekla in the currently active rendered view
• convert_cut_parts_to_real_parts: Convert all cut parts in the selected elements into real model parts

Requirements

Python 3.11, along with some libraries, is required. You can install all the necessary libraries by running:

$ pip install -r requirements.txt

Setting up

• Rename config/settings.sample.json to config/settings.json and adjust the values:

• Rename config/lifting_anchor_types.sample.json to config/lifting_anchor_types.json, and specify the components for the lifting anchors used in your projects along with their attributes
• Rename config/element_types.sample.json to config/element_types.json, and set the values of Tekla classes used in your model
• Configure tekla_mcp.py as a custom MCP server in your MCP client

Distribution

A standalone binary file can be created using PyInstaller for easier distribution. To do this, install PyInstaller:

$ pip install pyinstaller

Then, generate an executable with:

$ pyinstaller tekla_mcp.py

This will produce a binary file inside the dist/tekla_mcp/ directory, which can be distributed without requiring Python installation. Ensure the _internals directory is included alongside the binary.

Additionally, when using this option, configuration files should be copied to the _internals/config directory.

License

This software is open-source and released under the GPLv3 license. You are free to use, modify, and distribute it, as long as all modifications remain open-source under the same license.

For full details, please refer to the LICENSE file included in this repository.

Disclaimer

This software is provided as is, without any warranties or guarantees of functionality, reliability, or security. The developer assumes no responsibility for any damages, data loss, or other issues arising from its use.

Use at your own risk.