Skip to content

v0.3.0

Choose a tag to compare

@github-actions github-actions released this 22 Jun 07:07

Tekla MCP Server v0.3.0

The first release that can write to the model. Alongside reading and analysis, agents can now create, edit and delete objects — with a preview-by-default safety model — so prompts like "generate a frame", "fix the crooked columns" or "re-orient the flipped columns" map directly to tools instead of ad-hoc scripts.

What's new since v0.2.2

Geometry / grids

  • tekla_list_grids — list grid lines (axis, label, coordinate)
  • tekla_resolve_point — translate axis labels + elevation (e.g. 1 × Д × 6000) into model coordinates

Write primitives

  • tekla_create_beam, tekla_create_column, tekla_create_plate
  • tekla_modify_part (profile / material / class / name / endpoints)
  • tekla_swap_handles
  • tekla_delete_objects (by filter or GUID list)

Generators

  • tekla_generate_frame — a full bayed frame (columns + per-story beams)
  • tekla_create_column_grid — columns at every X×Y intersection
  • tekla_create_beam_between_grids — a beam between two grid intersections at an elevation

Find & fix

  • tekla_straighten_columns — re-plumb crooked columns
  • tekla_fix_column_handles — re-orient flipped columns (modeled as beams)

Safety model

  • Preview-by-default: every mutating tool takes apply (default false) and returns a plan (counts + preview) without changing anything. Pass apply=true to commit.
  • Created/modified objects are tagged with the MCP_ORIGIN user-defined attribute, so agent output is findable and revertible. Tekla Ctrl+Z also undoes commits.
  • Filter-based mutations are capped by a limit (default 200).
  • The Tekla backend forces the global coordinate system around writes so coordinates are interpreted as global model millimetres.

Notes

  • Verified against a live Tekla model; grid coordinate parsing now supports repeat syntax (e.g. 4*6000).
  • Coordinates are global model coordinates (mm).

Example use cases

  • "Generate a 3×2 bay frame, 6 m bays, 4 m story height, HEA300 columns / IPE300 beams — preview first."
  • "Find columns that aren't plumb and straighten them."
  • "Find columns modeled as beams with inverted handles and fix them."
  • "Create a beam between axes 1 and 2 along axis Д at +6.000."

Downloads

Asset Use case
TeklaMcp.Server-0.3.0-net48-win-x64.zip Production — Windows + Tekla Structures with an open model
TeklaMcp.Server-0.3.0-net8.0-mock.zip Development / testing without Tekla

Requirements

Windows + Tekla (net48):

  • Windows x64
  • Tekla Structures 2023+ (validated workflow)
  • Tekla running with a model open
  • .NET Framework 4.8 runtime

Mock backend (net8.0):

MCP client configuration

Extract the zip, then point your MCP client to the executable:

{
  "mcpServers": {
    "tekla": {
      "command": "C:\\path\\to\\TeklaMcp.Server.exe"
    }
  }
}

Keep the .exe and all .dll files in the same directory.

Full changelog

See CHANGELOG.md.