COMSOL Multiphysics MCP는 COMSOL Multiphysics 워크플로우를 위한 로컬 MCP 서버입니다. COMSOL 자동화, 데스크톱 지원, 가이드 모델링 워크플로우, 검증 도구, 결과 추출 및 RAG 보조 문서는 MCP 인터페이스를 통해 검색합니다.

중국어 문서: README.zh-CN.md

이것은 비공식적인 로컬 자동화 프로젝트입니다. COMSOL AB에 의해 승인, 또는 지원되지 않습니다.

특징

• ** COMSOL 자동화**: Python mph]을 통해 COMSOL 모델을 생성, 로드, 검사, 저장하고 해결합니다.
• Desktop 지원: COMSOL 데스크톱 창을 검사하고 스크린 샷을 캡처하고 Java Shell fallback 동작을 사용하여 GUI와 mph 세션을 동기화합니다.
• ** 모델링 도구 ** : 매개 변수, 구성 요소, 기하학, 선택, 재료, 물리학, 경계, 메쉬, 연구, 해결, 도형 및 수출 결과. -Guided 워크플로우: 일반적인 다중 물리 작업, 다음 단계 제안, 단계 검증 및 모델 완성 진단을위한 내장 템플릿.
• RAG-assisted modeling: 로컬로 제공하는 COMSOL 문서에 대한 로컬 ChromaDB의 검색
• 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