Enables AI clients to perform engineering simulations including structural FEM, thermal analysis, and CFD using local solvers.
Also known as novasolver/novasolver-studio, novasolver-studio
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- 214
- Latest version
- 0.8.1-registry.1
- Last commit
- Nov 15, 2026
- License
- GPL-3.0
What is NovaSolver Studio MCP?
NovaSolver Studio enables AI clients to perform engineering simulations including structural FEM, thermal analysis, and CFD using local solvers.
Summary generated from the project's README
About NovaSolver Studio MCP server
NovaSolver Studio provides a local engineering simulation environment that AI clients can control to perform structural, thermal, and fluid dynamics analysis. It allows developers and engineers to import STEP, STL, or IGES files and use an AI assistant to set boundary conditions, generate meshes, and run solvers like CalculiX and OpenFOAM. The system is designed to run entirely on your own computer, ensuring that sensitive models stay private through a numbers-only mode that prevents visual data from being sent to cloud AI models.
This server uses 35 typed tools to manage the simulation lifecycle, including mesh refinement and verification. Unlike standard solvers, it automatically performs mesh convergence checks using the GCI method to ensure results are reliable. Users can set up the server via Python using uvx or pipx, or by running the executable directly on Windows or Linux. The integration allows for a tight loop where an AI can model a part, analyze multiple versions, and stop if a mesh check fails or if stress exceeds yield limits.
What you can do with it
- 1Automated structural analysisAn AI client can import a STEP file, apply a specific load to a face, and calculate the resulting safety factor.
- 2Fluid dynamics simulationA developer can use the server to simulate pressure drops in a pipe elbow using OpenFOAM.
- 3Rapid surrogate modelingThe build_surrogate tool can solve multiple design variants in the background to create a fast prediction model.
Written from the project's README. Every use case is checked against a quote from it.
How to install NovaSolver Studio MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall NovaSolver Studio MCP in Claude Code
$ claude mcp add novasolver-studio -- uvx novasolver-studioInstall NovaSolver Studio MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"novasolver-studio": {
"command": "uvx",
"args": [
"novasolver-studio"
]
}
}
}Install NovaSolver Studio MCP in VS Code
.vscode/mcp.json
{
"servers": {
"novasolver-studio": {
"type": "stdio",
"command": "uvx",
"args": [
"novasolver-studio"
]
}
}
}Install NovaSolver Studio MCP in VS Code CLI
$ code --add-mcp '{"name":"novasolver-studio","type":"stdio","command":"uvx","args":["novasolver-studio"]}'Install NovaSolver Studio MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"novasolver-studio": {
"command": "uvx",
"args": [
"novasolver-studio"
]
}
}
}Install NovaSolver Studio MCP in Codex
$ codex mcp add novasolver-studio -- uvx novasolver-studioInstall NovaSolver Studio MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.novasolver-studio] command = "uvx" args = ["novasolver-studio"]
Install NovaSolver Studio MCP in Gemini CLI
$ gemini mcp add -s user novasolver-studio uvx -- novasolver-studioInstall NovaSolver Studio MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"novasolver-studio": {
"command": "uvx",
"args": [
"novasolver-studio"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablenovasolver/novasolver-studio is public and reachablegithub.com/novasolver/novasolver-studio ↗Pass
- Package names this repository as its sourcenovasolver-studio names novasolver/novasolver-studio as sourcepypi.org/project/novasolver-studio/ ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for novasolver-studiopypi.org/project/novasolver-studio/ ↗Pass
- Open source license (OSI)GPL-3.0spdx.org/licenses/GPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/novasolver/novasolver-studio ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from novasolver-studioPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubNovaSolver Studio
Free, local engineering simulation that your AI assistant can drive — and every answer is checked. Structural FEM, heat and CFD (CalculiX, OpenFOAM® and a built-in quadratic-tet solver) on your own PC, with an MCP server so Claude or any MCP client can import your STEP/STL, set the loads, run, refine the mesh and verify the result.
日本語 · 中文 · Try it in your browser (no install) · Download for Windows · novasolver.jp/studio

One sentence to the AI → Studio sets up and solves the case → mesh refined three times (GCI 1.5 %) → compared with a hand calculation. Real app, real numbers.

From one prompt, an AI modelled a bracket in SolidCraft and analysed three versions in Studio. It stopped without calling any of them a pass, because the mesh check had failed. 40 s video.
Why Studio
- Ran ≠ right. Every result carries three separate checks: ran → converged → mesh convergence. The third refines the mesh in three steps and reports the GCI (Roache), so you know the answer does not depend on the mesh; the built-in examples are also compared with closed-form or literature answers. None of this checks the boundary conditions or the design, and the AI is told to say exactly what was checked. Warnings that matter (stress above yield, a stress singularity at a sharp corner) are passed on, not hidden.
- Your models stay on your computer. No account, no upload, no telemetry. The only network use is the optional update check and example download (offline mode turns those off), and a public test fails if any other code starts using the network. For confidential work with a cloud AI, numbers-only mode keeps even pictures of the part away from the AI. See docs/PRIVACY.md.
- Real solvers, no licence fee. CalculiX for structural/thermal, OpenFOAM® for flow and water cooling, a built-in tet10 FEM for answers in seconds. Japanese, English and Chinese UI.
- Typed MCP tools, no shell. 35 tools (create/import, set conditions, mesh, run, convergence, verify, probe, sweep, render). The AI fills a case schema; Studio writes the solver input. Your AI's edits appear live in the window, and you can undo them.
- NovaSolver Flash: build an instant model of your own case.
build_surrogatesolves about 60 variants of a case in the background (loads, materials, template dimensions; a Gaussian process, checked on points held out of the fit).surrogate_predictthen answers in milliseconds with an error bar for the interpolation, and refuses outside the ranges. An imported CAD shape has no dimensions to vary yet. - Examples made with Flash: seven standard shapes. The
instant_estimatetool computes the peak stress or deflection, including for dimensions never solved, from a Gaussian process fitted to 1,396 solved points. No mesh, no solve. It gives the error bar and refuses outside the solved ranges. On 224 new solves it had never seen, 287 of 288 answers landed inside the bar. See the data.
![]() |
![]() |
| Pipe elbow, OpenFOAM® (pressure drop) | Cantilever vs beam theory |
Checked against known answers
A sample of the references Studio compares itself with (the full validation suite with every case, tolerance and
mesh-convergence column is published with each release as docs/VALIDATION.md):
| Case | Reference | Studio |
|---|---|---|
| Cantilever tip deflection | Euler–Bernoulli + shear | −0.9 % (built-in tet10, also in the browser demo) |
| Cylinder on a flat block, contact pressure | Hertz line contact | −0.04 % (mortar contact, 0.7) |
| Sphere drag, external flow | Schiller–Naumann | +0.3 % (OpenFOAM®, snappyHexMesh + wall layers) |
| Water-cooled plate | heat balance | 0.03 % |
| Lid-driven cavity | Ghia et al. | profile match (built-in and OpenFOAM®) |
How often does it get through a part it has never seen? docs/PART_TEST.md counts 246 STEP files, including every one that failed and why. Does it tell you when your setup is wrong? docs/SETUP_MISTAKES.md breaks correct setups in 34 ways, with the list fixed before the run, and shows what it said, misses included.
What it does / できること
| Analysis | Geometry | Quick preview (built-in, seconds) | Final solve | Verification |
|---|---|---|---|---|
| Structural: linear static, modal, nonlinear (plasticity, large deformation) | templates · import STEP / IGES / BREP / STL | quadratic tetrahedral FEM | CalculiX | beam theory, Heywood Kt, mesh convergence (GCI) |
| Buckling, contact (mortar, tied), fatigue (Goodman, S-N) — 0.7 | templates · import | quadratic tetrahedral FEM | — | Euler columns, Hertz, Goodman |
| Thermal (steady conduction), thermal stress | templates · import | quadratic tetrahedral FEM | CalculiX | Fourier's law, fin theory, GCI |
| Electrostatics, DC current and Joule heating | templates · import | quadratic tetrahedral FEM | — | εA/d, 2πεL/ln(b/a), L/(σA) |
| Internal flow | templates · import | 2D cavity (built-in) | OpenFOAM® | Ghia (cavity), Poiseuille, mass balance |
| Flow around a body | import | — | OpenFOAM® (snappyHexMesh + wall layers) | sphere drag vs Schiller–Naumann (+0.3%) |
| Water cooling (conjugate heat transfer) | import (2+ bodies) | — | OpenFOAM® (chtMultiRegionSimpleFoam) | heat balance (0.03%) |
Also: a Blender add-on (send the active object to Studio, PLA/PETG/ABS or metals),
a FreeCAD macro (send the selected part as STEP),
a 3D-print strength check (safety factor for each print direction in PLA/PETG/ABS, layer lines included), ParaView VTU / CSV / printable HTML report export, and a Windows installer with .nscase
file association.
Linux program (no Python needed)
Download NovaSolverStudio-<version>-linux-x86_64.tar.gz from Releases,
unpack it and run ./NovaSolverStudio. Each build is started and test-solved on Ubuntu 22.04 (x86-64) before release.
AI assistants connect with ./NovaSolverStudio mcp.
Install with Python (macOS / Linux / Windows)
After the first PyPI release, launch the GUI with uvx novasolver-studio, or install once with
pipx install novasolver-studio and run novasolver-studio. Python 3.10+ is required; Python 3.12 is tested in CI.
Older Python versions use compatible NumPy/SciPy/Matplotlib/WebSocket releases. The built-in FEM needs no external
solver. For an MCP client:
{
"mcpServers": {
"novasolver-studio": {
"command": "uvx",
"args": ["novasolver-studio", "mcp"]
}
}
}
With pipx, use "command": "novasolver-studio", "args": ["mcp"] instead.
Cases go to ~/NovaSolverStudio/workspace on macOS/Linux and ~/Documents/NovaSolverStudio/workspace on Windows;
NOVASTUDIO_WORKSPACE overrides this. Source checkouts keep their workspace/ folder.
| OS | CalculiX (optional structural/thermal solver) | OpenFOAM (optional CFD solver) |
|---|---|---|
| macOS | brew install costerwi/calculix/calculix-ccx |
brew install gerlero/openfoam/openfoam (Apple Silicon, macOS 14+) |
| Linux | sudo apt install calculix-ccx or the distro package |
Install ESI packages from openfoam.com; detected under /usr/lib/openfoam or via WM_PROJECT_DIR. |
| Windows | Put ccx_static.exe in solvers/calculix/ or set NOVASTUDIO_CCX. |
ESI Windows MinGW build plus Microsoft MPI, as described below. |
On headless Linux, Gmsh needs libglu1-mesa libgl1 libxrender1 libxcursor1 libxft2 libxinerama1.
NOVASTUDIO_CCX and NOVASTUDIO_OPENFOAM can select an installation on every OS.
macOS OpenFOAM tools run through the app environment launcher; Linux tools source the installation's etc/bashrc.
Quick start (developers) / 開発者向けの起動手順
python -m venv .venv
.venv\Scripts\python -m pip install "mcp>=2.3,<3" fastapi "uvicorn[standard]" numpy scipy matplotlib gmsh meshio psutil pyamg pymeshlab zstandard pytest
cd frontend && npm install && npm run build && cd ..
cd backend
set PYTHONPATH=%CD%
..\.venv\Scripts\python -m novastudio serve # open http://127.0.0.1:8765
Solvers are found automatically when installed (without them, the built-in preview solvers still work):
- CalculiX: put
ccx_static.exeundersolvers/calculix/or setNOVASTUDIO_CCX. - OpenFOAM (ESI Windows MinGW build): install to
%LOCALAPPDATA%\NovaSolverStudio\solvers\openfoam(an ASCII-only path) or setNOVASTUDIO_OPENFOAM. Put Microsoft MPI'smsmpi.dllin%LOCALAPPDATA%\NovaSolverStudio\solvers\msmpi.
Use it from an AI assistant (MCP) / AI アシスタントから使う
Easiest (Claude Desktop and other MCPB-aware apps): download novasolver-studio-<version>-win64.mcpb from
Releases and open it — the app installs it as an extension.
Also listed in the MCP Registry as io.github.novasolver/novasolver-studio.
With the downloaded zip: point any MCP client at the exe.
{
"mcpServers": {
"novasolver-studio": {
"command": "C:\\path\\to\\NovaSolverStudio\\NovaSolverStudio.exe",
"args": ["mcp"]
}
}
}
From source:
{
"mcpServers": {
"novasolver-studio": {
"command": "<studio>\\.venv\\Scripts\\python.exe",
"args": ["-m", "novastudio", "mcp"],
"env": { "PYTHONPATH": "<studio>\\backend" }
}
}
}
Then ask, for example: "Import bracket.step, fix the bottom face, push 500 N on the top face, run it, check mesh convergence and tell me the safety factor."
Electromagnetics (0.3) / 電磁気
The built-in tet10 solver now computes electrostatic potential, electric field and electrode charge, or DC current with optional steady Joule heating. STEP assemblies can assign a dielectric or conductor to each body. Three editable templates include analytic checks: capacitor against εA/d, coax against 2πεL/ln(b/a), and busbar against L/(σA) and the temperature rise σΔV²/(8k) with both ends cooled.
内蔵 FEM で静電場・電流・ジュール発熱による温度を計算できます。平行平板コンデンサ・同軸ケーブル・銅母線の 3 テンプレートには解析解との比較があり、任意形状ではメッシュ収束を確認できます。
Share face selection with an AI (0.4) / 選んだ面をAIと共有する
Select faces in the boundaries viewport, then ask “fix the faces I selected” or “put 500 N here”.
The assistant reads get_gui_selection, shows a numbered render_view(quantity="faces", highlight=[...])
to confirm the setup, and applies conditions through update_case. GUI and AI changes share one Undo/Redo
history. Ctrl+Z undoes the latest change by either of you; Ctrl+Shift+Z or Ctrl+Y redoes it.
Named face groups can be reused with boundaries.@<group>.role and other boundary fields.
画面で面を選んでから「選んだ面を固定して」のように頼めます。AIが選択内容を読み取り、面番号付きの画像で 確認してから条件を設定します。画面とAIの変更は共通の履歴に残り、どちらの変更も元に戻せます。 Hで選択した面を隠し、Alt+Hですべて表示。Ctrl+ドラッグで矩形選択、Xで透過表示を切り替えます。
在视图中选择面后,可以说“固定我选中的面”。AI会读取选择内容,用带面编号的图片确认设置,再应用边界条件。 界面与AI共用撤销和重做历史,双方的更改都可以撤销。面组可以保存并重复使用。
Documentation
- Design:
docs/DESIGN.md· Roadmap:docs/ROADMAP.md· Development notes:docs/DEVELOPMENT.md - Tests:
python -m pytest backend/tests -q
License
GPL-3.0 — see LICENSE. Programs called by Studio keep their own licenses — see
THIRD_PARTY_NOTICES.md.
The license covers the code, not the name. If you distribute a modified version, please give it a different name and do not present it as NovaSolver Studio or NovaSolver Flash.
This offering is not approved or endorsed by OpenCFD Limited, producer and distributor of the OpenFOAM software via www.openfoam.com, and owner of the OPENFOAM® and OpenCFD® trade marks.
Made by NovaSolver — interactive engineering simulators.
NovaSolver Studio MCP questions
How do I add NovaSolver Studio MCP to Claude Code?
Run claude mcp add novasolver-studio -- uvx novasolver-studio in your terminal. Add --scope user to make it available in every project.
How do I add NovaSolver Studio MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What solvers does NovaSolver Studio use?
It uses CalculiX for structural and thermal analysis, OpenFOAM for fluid dynamics, and a built-in quadratic-tet solver for quick previews.
How can I use this with Claude Desktop?
You can download the .mcpb extension from the releases page and open it to install it automatically.

