COMSOL MCP

可視化されたDesktopクライアントワークフローを備えた、AI駆動のCOMSOL用MCPサーバー。

comsol-mcp は以下のワークフローのために構築されています：

• 手動で COMSOL Multiphysics Server を起動する

• COMSOL Desktopがそのサーバーにビジュアルクライアントとして接続する

• MCPクライアントが同じサーバー側のモデルにアタッチする

• モデリングの変更がブラックボックスのバッチジョブとして実行されるのではなく、可視化されたまま維持される

このリポジトリは、このコードベースにおける可視化されたCOMSOL自動化の新しいメインラインです。 以前のバッチ指向のルートは、現在ではレガシーな参照用のみとなっています。

このプロジェクトが存在する理由

多くのCOMSOL自動化フローは強力ですが、不透明です。Javaをコンパイルしたり、バッチジョブを実行したり、汎用的なサーバーサイドシミュレーションを駆動したりすることはできますが、Desktop GUIでモデルが進化する様子を常に確認できるとは限りません。

comsol-mcp は異なる目標に焦点を当てています：

• 可視化されたGUIの変更

• 共有されたサーバーサイドのモデル状態

• Desktop側のポーリングブリッジなし

• GUI自動化レイヤーなし

• ブラックボックスのバッチ専用ワークフローなし

コアワークフロー

このプロジェクトは アタッチファースト（attach-first） ワークフローを使用します：

1. COMSOL Multiphysics Server を手動で起動します。

2. サーバーコンソールから実際のリスニングポートを確認します。

3. COMSOL Desktopを同じポートに接続します。

4. 必要に応じてサーバー側のモデルをDesktopにインポートします。

5. server_connect(host, port) を使用して、MCPを同じサーバーにアタッチします。

6. 作業モデルを作成またはロードします。

7. MCPツールを使用して、共有されているサーバー側のモデルを変更します。

8. COMSOL Desktopで同じモデルが更新されるのを確認します。

完全なバージョンについては、ワークフローガイドを参照してください。

クイックスタート

前提条件

• COMSOLがローカルにインストールされたWindows

• 有効な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とMCPは同じサーバーサイドモデルを共有しているため、Desktopには同じジオメトリが表示されるはずです。

ドキュメント形式の同じフローについては、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 は、GUIスクリプト/GUI自動化スタイルのプロジェクトです。すでに実行中のGUIで動作し、GUI自動化技術を使用してアクションをトリガーします。

comsol-mcp は、COMSOLに対して pywinauto スタイルのGUI自動化を使用しません。代わりに、COMSOL Multiphysics Server に直接アタッチし、Desktopが可視化しているのと同じサーバーサイドモデルを駆動します。

汎用的なCOMSOL自動化MCPとの比較

公開されているCOMSOL MCPのリストは、ソルバーの幅、メッシュ生成、物理設定、パラメトリックスイープの網羅性を強調することがよくあります。

このプロジェクトは、異なる価値提案を強調しています：

• アタッチファースト

• 可視化されたDesktopワークフロー

• 非ブラックボックスモデリング

• DesktopとMCP間でのモデル状態の共有

これは単なる「もう一つのCOMSOL自動化MCP」ではなく、Desktopクライアントとのワークフローを可視化し、共同作業可能にすることに特化しています。

旧バッチルートとの比較

以前のバッチルートでは以下を使用していました：

• comsolcompile

• comsolbatch

そのルートはオフラインジョブには依然として有用ですが、このプロジェクトの公的なアイデンティティではなくなりました。このリポジトリでは、メインラインではなくレガシーな参照として扱われます。

より詳細な比較については、docs/differences.mdを参照してください。

レガシー / 以前のバッチルート

このコードベースにおける以前の内部的な comsol-mcp ルートはバッチ指向であり、comsolcompile と comsolbatch をラップしていました。そのレガシーなルートは、意図的にこのリポジトリの公的な顔とはしていません。

このリポジトリは以下に焦点を当てています：

• COMSOL Multiphysics Server

• ビジュアルクライアントとしてのDesktop

• 同じモデルへのMCPのアタッチ

帰属

• MPh 上に構築

• COMSOLのクライアントサーバーワークフローおよび関連するMCPの探求に触発されました

• COMSOLとは提携していません

• COMSOLのバイナリや独自の資産は含まれていません

ライセンス

MIT。LICENSEを参照してください。