AI-копилот и Model Context Protocol (MCP)

Архитектура моста: Hub + Relay

WebCAE реализует интеграционный мост Model Context Protocol с топологией Hub + Relay, исключающей конфликты портов:

┌─────────────────────────────────────────────────────────────┐
│                       LLM КЛИЕНТЫ                           │
│  ┌───────────────────────────┐ ┌──────────────────────────┐ │
│  │   Claude Desktop / Code   │ │     Cursor / Antigravity │ │
│  └─────────────┬─────────────┘ └────────────┬─────────────┘ │
└────────────────┼────────────────────────────┼───────────────┘
          stdio (JSON-RPC)             stdio (JSON-RPC)
                 │                            │
                 ▼                            ▼
        ┌───────────────────┐        ┌───────────────────┐
        │  mcp-bridge (HUB) │◄───────┤ mcp-bridge (RELAY)│
        │  ws://127.0.0.1:  │  ws    │  (нет конфликта   │
        │       8765        │ relay  │   EADDRINUSE)     │
        └─────────▲─────────┘        └───────────────────┘
                  │
                  │ WebSocket (бидирекциональный JSON)
                  ▼
        ┌─────────────────────────────────────────────────┐
        │                WebCAE Приложение                │
        │  ┌───────────────────────────────────────────┐  │
        │  │ mcpBridgeConnector (авто-реконнект, FIFO) │  │
        │  └─────────────────────┬─────────────────────┘  │
        │                        ▼                        │
        │  ┌───────────────────────────────────────────┐  │
        │  │ window.cae API (CAD, Mesh, Physics, FEM)  │  │
        │  └───────────────────────────────────────────┘  │
        └─────────────────────────────────────────────────┘

Ключевые преимущества архитектуры: - Отсутствие конфликтов портов: Первый процесс сервера занимает локальный порт 8765 как HUB. Все последующие процессы (например, несколько окон Claude Desktop или параллельно открытый Cursor) автоматически становятся RELAY, пересылая запросы через HUB. При закрытии HUB один из процессов RELAY бесшовно перехватывает порт. - Управление активным окном: Мост гарантирует, что расчётные команды выполняет ровно одна активная вкладка WebCAE, переводя остальные в режим ожидания (standby) без сбоев. - Строгий контракт адресации (AGENTS.md): Все цели граничных условий адресуются исключительно номерами из единого журнала (surface number N, edge number N). Осевые псевдо-имена (+X, bbox_top) запрещены на уровне валидаторов Zod, что исключает галлюцинации LLM.

Сквозной сценарий работы AI-копилота

Типовой диалог инженера с AI-ассистентом:

1. Запрос пользователя: *«Оцени прочность стального кронштейна при нагрузке 4500 Н вниз на верхнюю грань, зафиксировав левый торец.»* 2. Инспекция геометрии: LLM вызывает cae_inspect_surfaces() и получает список граней с их нормалями и площадями. Модель безошибочно определяет торец (normal: [-1, 0, 0], грань #2) и верхнюю площадку (normal: [0, 0, 1], грань #1). 3. Назначение материала: LLM вызывает cae_set_material({ preset: "steel" }), задавая свойства стали ($E = 210\text{ ГПа}$, $\nu = 0.3$, $\sigma_y = 250\text{ МПа}$). 4. Граничные условия: - cae_add_boundary_condition({ targetNumbers: 2, type: "fix" }) - cae_add_boundary_condition({ targetNumbers: 1, type: "force", value: 4500, component: "z", fz: -4500 }) 5. МКЭ-расчёт и анализ запаса: LLM вызывает cae_solve(). WebCAE строит сетку, рассчитывает НДС и возвращает: - Максимальные напряжения по Мизесу: $\sigma_{\text{vM}}^{\max} = 142.5\text{ МПа}$ - Максимальные перемещения: $u^{\max} = 0.384\text{ мм}$ - Коэффициент запаса прочности: $\text{FOS} = \frac{250}{142.5} = 1.75$ (SAFE) 6. Визуальный контроль: LLM делает снимок через cae_screenshot() и выводит 3D-эпюру напряжений прямо в чат для подтверждения пользователю.