COMSOLマルチフィジックスMCPは、COMSOLマルチフィジックスワークフロー用のローカルMCPサーバーです。 COMSOL の自動化、デスクトップアシスタンス、ガイド付きモデリングワークフロー、検証ツール、結果抽出、および 1 つの MCP インターフェイスによる RAG アシストドキュメンテーション検索を公開します。

中国語の文書: README.zh-CN.md

非公式のローカルオートメーションプロジェクトです。 COMSOL ABでは、提携、推奨、またはサポートしていません。

##特徴

• COMSOL オートメーション: Python [mph] バックエンドを通じて、COMSOL モデルを作成、読み込み、検査、保存、および解決します。 -Desktop Assistance:COMSOLデスクトップウィンドウを調べ、スクリーンショットをキャプチャし、Java Shellフォールバックアクションを使用し、GUIと[mphセッション間で同期します。
• モデリングツール:パラメータ、コンポーネント、ジオメトリ、選択、材料、物理、境界、メッシュ、研究、解決、プロット、およびエクスポートされた結果。 -ガイドワークフロー:一般的なマルチフィジックスタスク、次のステップ提案、ステップ検証、モデルの完全性診断用の組み込みテンプレート。
• RAG-assisted modeling: ローカルのChromaDB検索をCOMSOLのドキュメント上でローカルに提供する。
• MCPの統合:Claudeデスクトップおよび他のMCP互換の顧客のためのstdio MCPサーバー.

COMSOL Multiphysics MCP

COMSOL Multiphysics MCP is a local MCP server for COMSOL Multiphysics workflows. It exposes COMSOL automation, Desktop assistance, guided modeling workflows, validation tools, result extraction, and RAG-assisted documentation retrieval through one MCP interface.

Chinese documentation: README.zh-CN.md

This is an unofficial local automation project. It is not affiliated with, endorsed by, or supported by COMSOL AB.

Features

• COMSOL automation: create, load, inspect, save, and solve COMSOL models through the Python mph backend.
• Desktop assistance: inspect COMSOL Desktop windows, capture screenshots, use Java Shell fallback actions, and sync between GUI and mph sessions.
• Modeling tools: parameters, components, geometry, selections, materials, physics, boundaries, mesh, studies, solving, plots, and exported results.
• Guided workflows: built-in templates for common multiphysics tasks, next-step suggestions, step validation, and model completeness diagnostics.
• RAG-assisted modeling: local ChromaDB retrieval over COMSOL documentation that you provide locally.
• MCP integration: stdio MCP server for Claude Desktop and other MCP-compatible clients.

Repository Layout

.
├── src/comsol_agent_mcp/      # MCP server and core implementation
│   ├── server.py              # FastMCP tool entrypoint
│   ├── config.py              # Environment variables and local paths
│   ├── backends/              # mph and COMSOL Desktop backends
│   ├── tools/                 # Modeling, solving, plotting, GUI tools
│   ├── workflows/             # Workflow templates and step manager
│   ├── validators/            # Model setup and result validation
│   ├── knowledge/             # Embedded docs and RAG retrieval
│   └── assistants/            # Natural-language modeling assistant
├── scripts/                   # Knowledge-base utilities
├── tests/                     # Automated tests
├── knowledge_base/            # Placeholder docs for the local RAG index
├── env.local.example          # Local configuration template
├── start-comsol-mcp.cmd       # Windows launcher
└── pyproject.toml             # Python package metadata

Paths written as ./path/ are relative to the repository root.

Requirements

• Python 3.10 or newer.
• A licensed local COMSOL Multiphysics installation for mph automation.
• Windows interactive desktop access if you want to use the GUI/Java Shell tools.
• Optional: local COMSOL PDF documentation and an embedding service key if you want to build the RAG knowledge base.

The GitHub repository does not include COMSOL, private licenses, .mph model files, generated simulation results, the author’s local Python environment, or a prebuilt vector database.

Installation

Clone or download the repository, then create your own Python environment from the repository root.

Windows PowerShell:

python -m venv .venv