Tekla MCP: агент работает с моделью и чертежами Tekla Structures

teknovizier/tekla_mcp_server· Проверено 12.11.2026· 63на GitHub

Подключает агента к открытой модели Tekla Structures: выбрать элементы по фильтру, прочитать свойства и UDA, вставить компоненты, расставить балки и колонны, проверить коллизии и выпустить чертежи.

2 реализации:

Сервер на Python: выбор и свойства элементов, вставка компонентов с подбором параметров, проверка коллизий, отчёты, печать и экспорт чертежей; 65 инструментов.

Как подключить

Что сделать до подключения

Windows и Tekla Structures: проверено на 2022 и 2026

Python 3.11 или новее, зависимости: uv pip install -r requirements.txt

Скопировать в папке config файлы *.sample.json без .sample: settings.json, element_types.json, semantic_overrides.json, base_components.json, report_properties.json

В settings.json указать tekla_path — папку bin вашей Tekla, например C:\Program Files\Tekla Structures\2022.0\bin

Перед вызовами держать Tekla запущенной с открытой моделью

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'TEKLA_MCP_CONFIG_DIR=<путь к tekla_mcp_server>\config' --transport stdio tekla \
  -- python '<путь к tekla_mcp_server>\src\tekla_mcp_server\mcp_server.py'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.tekla]
command = "python"
args = ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"]

[mcp_servers.tekla.env]
TEKLA_MCP_CONFIG_DIR = "<путь к tekla_mcp_server>\\config"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "tekla": {
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "tekla": {
      "type": "stdio",
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "tekla": {
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "tekla": {
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "tekla": {
        "type": "local",
        "command": [
          "python",
          "<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"
        ],
        "environment": {
          "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "tekla": {
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "tekla": {
      "command": "python",
      "args": ["<путь к tekla_mcp_server>\\src\\tekla_mcp_server\\mcp_server.py"],
      "env": {
        "TEKLA_MCP_CONFIG_DIR": "<путь к tekla_mcp_server>\\config"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

select_elements_by_filterвыбирает элементы по профилю, материалу, классу

select_elements_by_filter_nameвыбирает по сохранённому фильтру

get_elements_propertiesчитает свойства выбранных элементов

set_elements_propertiesменяет свойства и UDA

compare_elementsсравнивает элементы

put_componentsвставляет компонент Tekla

modify_componentsменяет атрибуты компонентов

draw_elements_labelsподписывает элементы в виде

show_only_selectedоставляет в виде только выбранное

color_selectedкрасит выбранное

cut_elements_with_cuttersвырезает элементы другими деталями

clash_checkпроверяет коллизии

check_for_invalid_objectsищет ошибочные объекты

create_reportстроит отчёт по шаблону

run_macroзапускает макрос Tekla

get_drawingsперечисляет чертежи

update_drawingsобновляет чертежи по модели

print_drawingsпечатает чертежи в PDF

export_drawingsвыгружает чертежи в DWG и DXF

place_beamsставит балки

Показано 20 из 65.

Готовый exe на C# под каждую версию Tekla 2021–2026: 120 инструментов, аналитика весов и UDA, геометрия, снимки вида; правки сначала показываются планом и применяются после подтверждения.

Как подключить

Что сделать до подключения

Windows x64 и Tekla Structures 2021–2026, запущенная с открытой моделью; .NET Framework 4.8 уже стоит там, где работает Tekla

Скачать со страницы Releases zip под свою версию Tekla, например TeklaMcp.Server-v0.9.0-tekla2023.zip, и распаковать, не разделяя файлы

Для Codex запустить из архива codex\Install-CodexPlugin.ps1 вместо ручной настройки

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio tekla-mcp-server \
  -- '<папка сервера>\TeklaMcp.Server.exe'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.tekla-mcp-server]
command = "<папка сервера>\\TeklaMcp.Server.exe"
args = []

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "tekla-mcp-server": {
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "tekla-mcp-server": {
      "type": "stdio",
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "tekla-mcp-server": {
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "tekla-mcp-server": {
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "tekla-mcp-server": {
        "type": "local",
        "command": ["<папка сервера>\\TeklaMcp.Server.exe"]
      }
    }
  }
}

{
  "mcpServers": {
    "tekla-mcp-server": {
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "tekla-mcp-server": {
      "command": "<папка сервера>\\TeklaMcp.Server.exe",
      "args": []
    }
  }
}

Инструменты сервера

tekla_get_connection_infoпоказывает открытую модель и версию Tekla

tekla_get_model_summaryсводит модель

tekla_find_objectsищет объекты по фильтру

tekla_count_objectsсчитает объекты

tekla_sum_weightсуммирует вес

tekla_group_weight_byгруппирует вес по профилю, материалу, UDA

tekla_get_propertiesчитает свойства объектов

tekla_discover_udasнаходит используемые UDA

tekla_set_udas_from_fileзаписывает UDA из файла

tekla_get_part_curve_geometryчитает геометрию гнутых деталей

tekla_find_modeling_issuesищет ошибки моделирования

tekla_get_numbering_statusпроверяет нумерацию

tekla_create_beamсоздаёт балку

tekla_modify_partsменяет детали

tekla_create_connectionсоздаёт соединение

tekla_list_drawingsперечисляет чертежи

tekla_create_drawingsсоздаёт чертежи

tekla_export_drawings_pdfвыгружает чертежи в PDF

tekla_capture_viewделает снимок вида модели

tekla_run_csharpвыполняет проверенный скрипт C#

Показано 20 из 120.

Что попросить агента

«Выбери все балки с профилем IPE300 и добавь подъёмные петли»teknovizier выберет элементы через select_elements_by_filter и вставит компонент через put_components

«Сгруппируй все детали по USER_FIELD_1 и покажи вес каждой группы»tempalg1n вызовет tekla_group_weight_by

«Я выделил детали — посчитай их вес по профилям»tempalg1n вызовет tekla_group_weight_by по выделенным объектам или tekla_sum_weight

«Какие сборочные чертежи выпущены, но изменены? Не открывай их»tempalg1n проверит список через tekla_list_drawings

«Проверь выбранные элементы на коллизии и подсвети конфликтующие»teknovizier вызовет clash_check и color_selected

Для каких задач

Выбрать все балки нужного профиля и вставить на них подъёмные петли

Сгруппировать детали по UDA или профилю и посчитать вес каждой группы

Найти коллизии, ошибочные и неотмеченные объекты перед выпуском

Расставить балки, колонны, плиты и сетку осей по координатам

Обновить, выпустить и напечатать чертежи в PDF или выгрузить в DWG

Ограничения

Оба сервера работают только на Windows и только с запущенной Tekla и открытой моделью

У tempalg1n 7 звёзд и версия 0.9.0 в ранней разработке: на живых моделях проверены Tekla 2021 и 2023, чертежи экспериментальные

Правка чертежа со статусом committed ещё не сохранена: без tekla_save_drawing Tekla теряет её при повторном открытии модели

Скан всей модели упирается в таймаут клиента около 60 секунд: большие выборки идут частями через maxObjects и cursor

Если не работает

Конфликт Python-пакета clr

Переименуйте или удалите папку site-packages\clr в каталоге вашего Python, например C:\Users\User\AppData\Local\Programs\Python\Python313\Lib\site-packages\clr.

teknovizier не связывается с Tekla

Запустите Tekla с открытой моделью и проверьте tekla_path в settings.json. Для Tekla 2026 в <tekla_path>\Net48Runtime должны лежать библиотеки Tekla.

teknovizier не подхватывает настройки

Конфиги читаются один раз при старте: перезапустите сервер. Проверьте, что в config есть все пять JSON и в них нет запятых в конце и комментариев.

tempalg1n пишет «Not connected», хотя Tekla открыта

Сервер сам подбирает канал Tekla 2021–2023 и перечисляет найденные в ошибке. Чтобы задать канал вручную, укажите точное имя в переменной TEKLA_MCP_CHANNEL.

tempalg1n не находит папку Open API Tekla

Задайте путь к ней в переменной TEKLA_BIN_DIR. Архив под другую версию Tekla сервер отклонит и назовёт нужный.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Tekla MCP Server (teknovizier)	teknovizier	63	локально	не нужен	65	11 ноября 2026
Tekla MCP Server (tempalg1n)	tempalg1n	7	локально	не нужен	120	19 октября 2026

Частые вопросы

Какой вариант выбрать?

teknovizier — сервер на Python с гибкой настройкой компонентов и правилами для подъёмных петель, у него 63 звезды. tempalg1n — готовый exe без Python, 120 инструментов, аналитика весов и предпросмотр всех правок перед применением.

Можно ли запретить агенту менять модель?

Да. У teknovizier задайте read_only: true в settings.json, у tempalg1n — переменную TEKLA_MCP_READ_ONLY=1. Останутся только инструменты чтения, выбора и вида.

Можно ли отменить то, что сделал агент?

У tempalg1n запись по умолчанию идёт с apply=false: сервер возвращает план и ничего не меняет, пока агент не получит подтверждение. Созданные и изменённые объекты помечаются UDA MCP_ORIGIN, а Ctrl+Z в Tekla отменяет применённые правки.

Можно ли попробовать без Tekla?

Да, у tempalg1n есть архив …-net8.0-mock.zip: он отдаёт небольшую тестовую модель на любой ОС, нужен .NET 8.

Как подключить Tekla MCP к Codex?

У tempalg1n в архиве релиза есть скрипт codex\Install-CodexPlugin.ps1: он собирает карточку плагина Tekla MCP для Codex. Для teknovizier откройте вкладку Codex в блоке «Как подключить».

Работает ли сервер из России?

Серверы работают на вашем компьютере рядом с Tekla и сами в сеть не ходят; ключи и аккаунты не нужны.

Tekla MCP: агент работает с моделью и чертежами Tekla Structures

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы