COMSOL MCP

MCP-сервер на базе ИИ для COMSOL с рабочим процессом через визуальный настольный клиент.

comsol-mcp создан для рабочего процесса, в котором:

• вы вручную запускаете COMSOL Multiphysics Server

• COMSOL Desktop подключается к этому серверу как визуальный клиент

• MCP-клиент подключается к той же модели на стороне сервера

• изменения в модели остаются видимыми, а не выполняются как пакетное задание в «черном ящике»

Этот репозиторий является новой основной веткой для визуальной автоматизации COMSOL в данной кодовой базе. Старый путь, ориентированный на пакетную обработку, теперь является лишь устаревшей справочной информацией.

Почему существует этот проект

Многие процессы автоматизации COMSOL мощны, но непрозрачны. Они могут компилировать Java, запускать пакетные задания или управлять общими симуляциями на стороне сервера, но они не всегда позволяют наблюдать за развитием модели в графическом интерфейсе Desktop.

comsol-mcp фокусируется на другой цели:

• видимые изменения в графическом интерфейсе

• общее состояние модели на стороне сервера

• отсутствие моста опроса на стороне Desktop

• отсутствие уровня автоматизации графического интерфейса

• отсутствие рабочего процесса только через пакетные задания в «черном ящике»

Основной рабочий процесс

Этот проект использует рабочий процесс «сначала подключение» (attach-first):

1. Запустите COMSOL Multiphysics Server вручную.

2. Запишите реальный порт прослушивания из консоли сервера.

3. Подключите COMSOL Desktop к тому же порту.

4. При необходимости импортируйте модель с сервера в Desktop.

5. Подключите MCP к тому же серверу с помощью server_connect(host, port).

6. Создайте или загрузите рабочую модель.

7. Используйте инструменты MCP для изменения общей модели на стороне сервера.

8. Наблюдайте за обновлением той же модели в COMSOL Desktop.

Полную версию см. в руководстве по рабочему процессу.

Быстрый старт

Предварительные требования

• Windows с установленным локально COMSOL

• Действующая лицензия COMSOL

• Python 3.10 или новее

• Вручную запущенный COMSOL Multiphysics Server

Установка

Из исходного кода:

git clone <your-repo-url> comsol-mcp
cd comsol-mcp
python -m pip install -e .

Установите переменные окружения:

$env:COMSOL_ROOT = "C:\Program Files\COMSOL\COMSOL63\Multiphysics"
$env:COMSOL_SERVER_MCP_HOME = "$PWD\comsol-server-home"

Запустите MCP-сервер:

python -m comsol_mcp.mcp_server

Или используйте вспомогательный скрипт:

.\scripts\start_comsol_mcp.ps1 -Python python -ComsolRoot "C:\Program Files\COMSOL\COMSOL63\Multiphysics" -McpHome "$PWD\comsol-server-home"

Пример конфигурации MCP

См.:

• examples/claude_desktop_config.json

• .mcp.json

Минимальная визуальная демонстрация

server_connect("localhost", <actual_port>)
model_create("VisibleServerModel")
ensure_component("comp1", 2)
ensure_geometry("comp1", "geom1", 2)
ensure_mesh("comp1", "mesh1")
create_feature("comp1", "geom1", "r1", "Rectangle", "[{\"name\":\"size\",\"values\":[\"60[mm]\",\"30[mm]\"]},{\"name\":\"pos\",\"values\":[\"-30[mm]\",\"-15[mm]\"]}]", true)
run_feature("mesh", "mesh1", "comp1")

В Desktop должна отображаться та же геометрия, поскольку Desktop и MCP используют одну и ту же модель на стороне сервера.

См. examples/attach_first_demo.md для ознакомления с тем же процессом в виде документа.

Набор инструментов

Текущие инструменты:

• server_info()

• server_start(...)

• server_connect(host, port, model_name="")

• server_disconnect(shutdown_server=false)

• model_create(name="Server Model")

• model_load(path)

• model_tree()

• get_parameters()

• set_parameters(parameters_json)

• ensure_component(component="comp1", dimension=2)

• ensure_geometry(component="comp1", geometry="geom1", dimension=2)

• ensure_mesh(component="comp1", mesh="mesh1")

• create_feature(component, geometry, tag, feature_type, properties_json="[]", run_geometry=false)

• update_feature(component, geometry, tag, properties_json, run_geometry=false)

• delete_feature(component, geometry, tag, run_geometry=false)

• run_feature(collection, tag, component="comp1")

• run_study(study_tag="")

• save_model(path="")

Набор инструментов моделирования намеренно сделан стабильным. Очистка этого репозитория не переименовывает и не удаляет эти инструменты.

Рекомендуемая точка входа

Рекомендуемая точка входа:

server_connect("localhost", <actual_port>)

server_start() по-прежнему доступен, но теперь это расширенный резервный вариант. Используйте его только тогда, когда хотите, чтобы MCP управлял жизненным циклом сервера COMSOL, и готовы к тому, что COMSOL может автоматически выбрать другой порт прослушивания.

Известные ограничения

• COMSOL Desktop может не отображать автоматически модель на стороне сервера после успешного подключения; возможно, вам потребуется импортировать или переключиться на существующую модель сервера.

• server_connect() может завершиться успешно, даже если не выбрана текущая рабочая модель; в этом случае используйте model_create() или model_load().

• Вывод консоли сервера и фактический порт прослушивания всегда следует сверять с реальным активным прослушивателем.

• Графика Desktop может потребовать легкого обновления после изменений модели на стороне сервера.

См. руководство по устранению неполадок.

Чем это отличается от других MCP

В сравнении с abaqus-mcp-server

abaqus-mcp-server — это проект в стиле скриптов графического интерфейса / автоматизации графического интерфейса. Он работает с уже запущенным графическим интерфейсом и использует методы автоматизации графического интерфейса для запуска действий.

comsol-mcp не использует автоматизацию графического интерфейса в стиле pywinauto для COMSOL. Вместо этого он подключается напрямую к COMSOL Multiphysics Server и управляет той же моделью на стороне сервера, которую визуализирует Desktop.

В сравнении с общими MCP для автоматизации COMSOL

Публичные списки COMSOL MCP часто делают упор на широту решателей, генерацию сетки, настройку физики и покрытие параметрических разверток.

Этот проект подчеркивает другое ценностное предложение:

• «сначала подключение»

• визуальный рабочий процесс Desktop

• моделирование без «черного ящика»

• общее состояние модели между Desktop и MCP

Это не просто «еще один MCP для автоматизации COMSOL»; он специально создан для того, чтобы сделать рабочий процесс видимым и совместным с клиентом Desktop.

В сравнении со старым пакетным путем

Старый пакетный путь использовал:

• comsolcompile

• comsolbatch

Этот путь все еще полезен для автономных заданий, но он больше не является публичным лицом этого проекта. В этом репозитории он рассматривается как устаревшая справочная информация, а не как основная ветка.

См. docs/differences.md для более полного сравнения.

Устаревший / Предыдущий пакетный путь

Более ранний внутренний путь comsol-mcp в этой кодовой базе был ориентирован на пакетную обработку и обертывал comsolcompile плюс comsolbatch. Этот устаревший путь намеренно не является публичным лицом этого репозитория.

Этот репозиторий фокусируется на:

• COMSOL Multiphysics Server

• Desktop как визуальный клиент

• Подключение MCP к той же модели

Атрибуция

• Построено на базе MPh

• Вдохновлено рабочими процессами клиент-сервер COMSOL и связанными исследованиями MCP

• Не связано с COMSOL

• Не включает бинарные файлы COMSOL или проприетарные активы

Лицензия

MIT. См. LICENSE.