radia-mcp

Cubit MCP is independently distributed with cubit-mesh-export, under cubit_mesh_export.mcp; it is no longer included here. Install the exporter and launch mcp-server-cubit for Cubit-only work. Each distribution contains its own required runtime support. Radia's optional topology/CAD workflows may call the Cubit package; Cubit itself requires neither Radia package. The former cae-mcp-core foundation is retired: it is not a dependency or shared runtime. radia-mcp owns radia_mcp.common/radia_mcp._shared, while cubit-mesh-export owns its independent runtime support.

Optimization now has a solver-neutral and electromagnetic two-layer boundary, composed through the existing radia-design profile.

For fewer client processes, use the capability packs. They combine related domains with startup-selected profiles while preserving old commands. paper-writing now includes grant and poster tools as well as slides and figures; genre-specific scoring remains separate.

For standard client settings, safe editable updates and behavioral acceptance, see the maintenance procedure and known-issue ledger.

First-and-only public Model Context Protocol (MCP) server suite for Gmsh, build123d, and the Radia CAE ecosystem, with independent Cubit integration — including differential geometry and Mathematica integration. Pioneering MCP territory for mesh generators worldwide.

Killer demo (30 seconds): ask Claude to derive the Kelvin transform factor by hand — it gets stuck on a 3×3 Jacobian + 27-term Laplacian. Then ask it to use differential-forms + mathematica together:

> verify_with_mathematica(identity="kelvin")

Claude pulls the recipe, sends it to Wolfram, reports back

k=1:  Laplacian(psi) = 0          [harmonic — factor R/|y| is correct]
k=2:  Laplacian(psi) ≠ 0          [factor wrong]
k=3:  Laplacian(psi) ≠ 0          [factor wrong]

— in 8 seconds. The kelvin_factor = R/|y| that takes half a day in vector calculus appears as the conformal weight λ^((n−2k)/2) of a k-form, and Mathematica verifies it symbolically.

Authored by the Sugawara Lab (菅原研究室), Kindai University — where the lab-standard primary pair is build123d (CAD authoring) + Cubit (hex meshing), with Gmsh as the post-processing workhorse.

Why this exists

radia-mcp lets an AI assistant drive a real CAE pipeline end-to-end:

build123d script  →  STEP  →  Cubit hex mesh  →  .msh v4.1 / .vol  →  ngsolve / radia
        ↑                            ↓
   AI authors                   AI iterates safely
   (Builder API)                 (auto-checkpoint
                                  + batch dry-run
                                  + persistent headless replay)

What makes it different from typical CAD-MCP servers (FreeCAD, OpenSCAD, Blender):

Test-then-reflect safety pattern: every risky operation auto-checkpoints to .cub5, runs in a disposable batch Cubit first, applies to the persistent headless session only when batch passes cleanly. The user watches success paths, not failures.
Scheme ladder with geometry split: cubit_mesh_auto walks auto → sweep → polyhedron → tetmesh, auto-detects compound bodies (volume/surface ratio heuristic) and auto-webcuts before retrying.
Universal mesh backend for the CAD-MCP ecosystem: any_step_to_cubit_hex accepts STEP from any upstream MCP (FreeCAD-MCP / OpenSCAD-MCP / cadquery-mcp / Blender-MCP / Onshape-MCP / KiCad-MCP) and dispatches to the same hex-mesh backend.
Deeply scraped knowledge (≈800 lab files + 65 build123d examples
- 15 bd_warehouse + GitHub issues + GitLab issues + StackOverflow + YouTube tutorial transcripts + Coreform training pack), all searchable via tf-idf with heading boost.
Symbolic verification of FEM formulations (no other MCP server does this). Pair differential-forms (theory: Bossavit Whitney complex, Arnold-Falk-Winther FEEC, Kameari edge elements) with mathematica (Wolfram subprocess bridge) to:
- Verify d² = 0 on any specific function
- Compute element mass / stiffness matrices on a unit tetrahedron in closed form
- Derive kelvin_factor = R/|y| for the Kelvin transformation from the conformal-weight formula
- Output paper-quality TeX for hand-tuned identities Backed by 21-PDF cohomology bibliography (Bossavit 1998, FEEC 2006, Whitney 1957, Kameari 2011, Codecasa 2010, 新しい計算電磁気学 2003 ...).

Validated EM & multiphysics engineering (`radia-ngsolve`)

Most CAE-MCP servers stop at generating a script. radia-ngsolve goes further: an AI assistant can solve a real electromagnetics / multiphysics engineering problem in open-source NGSolve, and every capability is cross-checked against a closed-form analytic solution. The result is a library you can trust an AI to drive.

20+ "COMSOL-class" problems, each validated and baked in

Each model ships as a reusable helper + runnable example + regression test + queryable knowledge (ngsolve_usage(...)), so the server gets smarter, not just a pile of scripts. Agreement with the closed form is typically well under 1 %:

Domain	Examples (validation vs closed form)
Electrostatics	3-D capacitance (<0.2 %), layered dielectrics (0.1 %), capacitance matrix (0.03 %), electrostatic force (0.4 %), two-wire line (0.1 %)
Magnetostatics	μ-metal shielding sphere/cylinder (0.9–1.3 %), Halbach PM dipole (0.3 %), cylinder magnet on-axis (centre 0.01 %), finite solenoid + Nagaoka inductance (0.5 %), Helmholtz uniformity (<1 %), iron-yoke dipole gap field (0.5 %)
Field quality	accelerator-magnet multipoles b_n / a_n — normal-quad main term 0.02 %, allowed/forbidden harmonics resolved
Eddy / AC	round-wire skin effect R_ac/R_dc vs Kelvin ber/bei (0.07 %), induction heating
Force / torque	weighted Maxwell-stress ("eggshell") force & torque, busbar Lorentz force (~1 %)
Multiphysics	electro-thermal Joule heating (exact), electro-thermo-mechanical thermal-stress chain (exact), magneto-mechanical Lorentz→beam deflection vs Euler-Bernoulli (0.02 %)

Many cases are additionally cross-checked, internally, against a reference commercial FEM solver (three-way agreement analytic = open-source = commercial); the published numbers above are all against the closed-form analytic, the unimpeachable reference.

Designer-facing, not textbook

The helpers take what an engineer actually has — material, geometry, excitation — and return what they want: capacitance, shielding factor, multipole spectrum, inductance, force/torque, temperature rise, thermal stress, deflection. Ask the MCP server ngsolve_usage("field_quality"), ("solenoid"), ("c_magnet"), ("elasticity"), … for the validated recipe (70+ topics), or lint_radia_script to catch the known FEM traps before they cost a debug session.

How it's built

Pure-Python NGSolve (H1 / HCurl / axisymmetric H1Henrotte / VectorH1 elasticity), small reusable solvers chained for couplings, fast pytest contracts for package health, and explicit validation scripts under validation/ that lock every number above. Open source (BSD-3); validated against closed-form analytics, with commercial solvers used only as an internal benchmark.

Demo (placeholder — recordings to be added)

build123d_to_cubit_hex(script=generate_build123d_script("helix_coil")["script"], target_size=1.0) in one call:

1. build123d Builder API: 4-turn helix + 2 radial leads (3 prismatic bodies)
2. STEP export → /tmp/coil.step
3. cubit_batch_try (headless): scheme ladder
   ├─ auto → 1668 hex / 0 tet ✓ WIN
   └─ (sweep / polyhedron / tetmesh skipped)
4. persistent headless replay → artifacts and diagnostics record the winner
5. .cub5 checkpoint preserved for rollback

Total time: ~30 s on a 4-core laptop. AI watches state delta, applies hint heuristics on failure, and never leaves a half-broken mesh in the user's window.

Install

pip install radia-mcp                # MCP guidance; no Radia solver or Cubit runtime required
pip install radia-mcp[build123d]      # adds build123d itself
pip install radia-mcp[build123d,cubit] # optional STEP-to-Cubit execution (Windows, Python 3.12)
pip install radia-mcp[cadquery]       # adds CadQuery (interop with cadquery-mcp)
pip install radia-mcp[gmsh]           # adds gmsh Python bindings for optional GMSH workflows
pip install radia-mcp[youtube]        # adds youtube-transcript-api (tutorial scrape)
pip install radia-mcp[radia]          # adds Radia core (radia-coupled servers)
pip install radia-mcp[full]           # everything above

Install the standalone MATLAB distribution and the official Optuna MCP server separately; neither is a runtime dependency of radia-mcp:

pip install --upgrade radia-optuna
pip install --upgrade optuna optuna-mcp

The ownership rule is strict: the official optuna/optuna-mcp live tools/list owns every shared Study/Trial/query/visualization/Dashboard operation it exposes. mcp-server-radia-matlab supports only the MATLAB differences through matlab_optuna_mcp_route: table/MAT persistence, OptimizationSession lifecycle/checkpoint/selection, Simulink controls and telemetry, MATLAB parallel execution, the required 21-command optuna_mex, and Radia CAE artifact adapters. Seeded numerical oracle checks execute pinned optuna==4.9.0 directly because the verified upstream MCP sampler tool does not expose a seed.

The MATLAB difference lane is executable rather than descriptive: matlab_optuna_health checks the distribution manifest, required-scope evidence mapping separately from wider assertion mapping, oracle hashes, MEX, Simulink entries, and notices; matlab_optuna_oracle_plan produces official-MATLAB-MCP-ready test code; matlab_optuna_benchmark_plan fixes the same-host seeded workloads; and matlab_optuna_release_gate accepts only a byte-matched installed wheel, all policy-classified tests, standalone Simulink/table-resume evidence, matching checksums, and warmed MATLAB medians no slower than upstream Python.

radia-optuna is independent and unofficial; it is not affiliated with, sponsored by, or endorsed by Preferred Networks, Inc. or the Optuna project. Optuna, the Optuna logo and any related marks are trademarks of Preferred Networks, Inc. Radia does not use the Optuna logo or present its MCP layer as official. Optuna and optuna-mcp are MIT-licensed upstream projects; their copyright/license notices are bundled in the radia-optuna wheel's THIRD_PARTY_NOTICES.md. Oracle regeneration starts the official MCP locally over stdio with a fresh temporary SQLite database. Routine tests use the checked fixture, do not launch Dashboard, do not touch shared/production storage, and do not automatically open upstream issues or pull requests.

matlab_optuna_compatibility_contract and matlab_optuna_oracle_audit expose the pinned direct-Python and real-stdio-MCP evidence behind that health gate. Unseeded constructors use fresh private entropy; exact proposal parity uses an explicit seed.

Requires Python ≥ 3.10. The optional cubit extra installs the separately owned cubit-mesh-export on Windows/Python 3.12 only; it does not install or license Coreform Cubit. On other platforms use build123d + Netgen for .vol generation. Cubit setup and discovery are documented by the exporter.

Release Quality Stance

radia-mcp treats a green test matrix as release-candidate evidence, not as the final operational claim. The public MCP surface is healthy when the matrix, policy lint, version consistency, live catalog contracts, and top-level pytest collection all pass. Tool discovery is verified from radia_mcp.meta and each server's actual tools/list; generated inventory snapshots are not committed or used as a CI oracle.

Operational quality is claimed only after the published wheel is verified, editable registration and fresh imports pass on LAB and 100, and LAB confirms the affected live source and a harmless tool call. Existing 100 clients may adopt the update on their next normal launch; they do not block the release. The numerical solver's four-host release-quad is a separate workflow. Public-safe quality records live in validation/mcp_quality/.

★ Discovery — start here

Before calling any specific server, ask mcp-server-radia-meta which server has the knowledge you need. It is the authoritative cross-server catalog of the current radia-mcp servers and answers "which tool covers concept X?" without trial-and-error.

# catalog, health, golden-gate, and bug-pattern tools
radia_mcp_overview()                  # current server catalog + live tags
radia_mcp_get("bayesian-opt")         # full info for one server
radia_mcp_by_tag("optimization")      # filter optimization/theory servers
radia_mcp_related("bayesian-opt")     # cross-link map for optimization servers
radia_mcp_health()                    # importability probe of the current catalog
radia_mcp_golden_gate()               # catalog/discovery/public-boundary gate

Then drill into a specific server with its <short>_status() (auto- introspected tool list + dep probe) and <short>_topics() (for dispatcher-style servers: the topic enum) tools.

The production MCP surface uses the core profile: primary workflows remain direct tools, while fine-grained validation and artifact-identity checks are searched with <short>_validation_catalog(query=...) and executed through <short>_validation_run(name=..., arguments=...). This keeps tools/list small without deleting the checked Python operations. For migration or low- level debugging only, set RADIA_MCP_TOOL_PROFILE=full (or pass --tool-profile full) to restore the historical individual gate tools.

Pattern: 3-call discovery instead of guess-and-error —

radia_mcp_by_tag("optimization")
  → [bayesian-opt, evolutionary, topology-optimization,
     data-assimilation, gnn, pinn]
  → bayesian_opt_status()        # confirm radia-side theory tools
  → bayesian_opt_topics()        # topic enum for BO / GP / FMQA
  → official optuna-mcp          # every shared operation in live tools/list
  → matlab_optuna_mcp_route()    # MATLAB/Simulink differences only

MCP servers

The catalog is the source of truth — call radia_mcp_overview() for the current live list. The historically primary servers are shown below for reference; everything else is discoverable via meta.

Standalone (no Radia core dependency — `pip install radia-mcp`)

Server	Entry point	Access	Highlights
★ meta	`mcp-server-radia-meta`	direct	Cross-server catalog + health/golden gate — RECOMMENDED FIRST CALL
literature-index	`mcp-server-literature-index`	direct	Full-text search across 2,339 lab literature files in W:/03_文献・論文 (ChromaDB + semantic search)
build123d	`mcp-server-build123d`	direct + validation catalog	`build123d_to_cubit_hex`, `lint_build123d_script`, `build123d_try` (subprocess isolation), `build123d_inspect_step`, `build123d_heal`, `build123d_api`, Radia/general templates, CadQuery + bd_warehouse interop
GMSH	`mcp-server-gmsh`	direct	`lint_gmsh_script`, `gmsh_audit_summary`, `gmsh_numsubedges_remediation_plan`, `gmsh_mesh_generation_remediation_plan`, references + examples
Force	`mcp-server-force`	direct + validation catalog	Common Motor/MagLev force layer: shared result normalization; static and peak/RMS phasor Lorentz/Maxwell force and torque; virtual work, coenergy and uniform/sampled air-gap torque; method selection, independent-method/action-reaction/lift-weight gates; and validation guidance (numerical tools require the `radia` extra).
differential-forms	`mcp-server-differential-forms`	direct	Visual differential geometry for computational EM: intrinsic metric, curvature/holonomy, Cartan moving frames, k-forms, exterior derivative, Hodge star, Whitney complex, de Rham, tree-cotree, FEEC, and executable geometry/gauge gates. Distilled from Needham 2021/2026, Bossavit 1998, Whitney 1957, Kameari 2011, Arnold-Falk-Winther 2006, 新しい計算電磁気学 2003, and Codecasa 2010.
mathematica	`mcp-server-mathematica`	direct	Wolfram Mathematica subprocess bridge: evaluate expressions, execute tracked verification scripts with JSON reports, batch named identities in one kernel, and select a course/differential-forms/paper verification workflow, plus simplify, TeX, vector calculus, units, solve, integrate, differentiate, and status helpers. Pairs with `differential-forms` for symbolic verification of d²=0, Stokes, Whitney elements, Kelvin transform, Maxwell identities. Requires `wolframscript` on PATH.

Radia-coupled (`pip install radia-mcp[radia]`)

Server	Entry point	Highlights
radia-ngsolve	`mcp-server-radia-ngsolve`	NGSolve FEM/BEM, Whitney elements via H1/HCurl/HDiv, PEEC inductance, closed-form formulas (Wakao-Igarashi Part 1-9, cuboid average B, Bessel impedance, etc.)
ih	`mcp-server-ih`	Induction heating workflow: workpiece SIBC, ESIM nonlinear cell problem, Karl iteration, screening physics
peec	`mcp-server-peec`	PEEC: Loop-Star, FastHenry, PyPEECBuilder, Bessel/Dowell/ESIM SIBC, PRIMA model-order reduction, SPICE extraction
electromagnet	`mcp-server-electromagnet`	Accelerator magnets: magnetic rigidity and beam-optics handoff, normal/ramped/superconducting design, field measurement, curated textbook guide, CoilBuilder, Hantila, hysteresis, IMA, and multipoles

Claude Code / Desktop configuration

Add to your MCP client config (Claude Desktop, Claude Code, Cursor, Continue, …):

{
  "mcpServers": {
    "radia-meta":          {"command": "mcp-server-radia-meta"},
    "literature-index":    {"command": "mcp-server-literature-index"},
    "build123d":           {"command": "mcp-server-build123d"},
    "gmsh":                {"command": "mcp-server-gmsh"},
    "force":               {"command": "mcp-server-force"},
    "differential-forms":  {"command": "mcp-server-differential-forms"},
    "mathematica":         {"command": "mcp-server-mathematica"},
    "radia-matlab":        {"command": "mcp-server-radia-matlab"},
    "optuna": {
      "command": "optuna-mcp",
      "args": ["--storage", "sqlite:///C:/temp/optuna_mcp.db"]
    }
  }
}

The path above is an example of user-owned persistent local storage. Automated oracle tests must instead create a unique database in the per-run temporary directory and delete it after the local stdio server exits.

Register only the workflows you need — once you have meta, radia_mcp_get(name) returns the entry point for any of the cataloged servers and you can register them on demand. The full list of catalog-driven server names is in radia_mcp.meta.catalog.CATALOG.

Optional external Cubit configuration, after installing cubit-mesh-export and a licensed Coreform Cubit (not provided by radia-mcp):

{
  "mcpServers": {
    "cubit": {
      "command": "python",
      "args": ["-m", "cubit_mesh_export.mcp.server"]
    }
  }
}

Knowledge bases shipped (offline)

Server	Bundled knowledge	Lines
build123d	Auto-generated API reference (`inspect.getmembers`, 142 classes / 65 functions) + 18 curated topics (Plane/Axis/Location cookbook, Builder ↔ Algebra rosetta, joints, assemblies, CAE workflow, …)	1 673
GMSH	Visualization/post-processing policy, MSH v4.1 spec, high-order display guidance, lint rules, examples, and remediation planners	2 008

Plus persistent failure log per kind, fed into every *_lookup / *_ask retrieval so past mistakes are searchable next session.

Live-scraped knowledge (cached 7 days)

Cubit rows below describe the external exporter MCP, not bundled Radia MCP content. Consult its own catalog for current source availability.

Source	Kind	Volume
Coreform forum (Discourse)	`cubit_examples`	full archive walk, ≈ 60 code-bearing posts
`S:\CoreformCubit` + `Radia/01_GitHub/examples`	`cubit_examples`	787 `.jou` / `.py` files (lab archive + Coreform training pack)
Cubit YouTube tutorials	`cubit_examples`	5 transcripts
GitHub `.jou` code search (PAT)	`cubit_examples`	15 files
`gumyr/build123d/examples`	`build123d_examples`	65 scripts
`gumyr/bd_warehouse`	`build123d_examples`	15 modules
`gumyr/build123d` Issues + GraphQL Discussions	`build123d_examples`	60 + 50
build123d YouTube	`build123d_examples`	4 transcripts
`gitlab.onelab.info/gmsh/gmsh` issues	`gmsh_examples`	walking 3000+
StackOverflow / SciComp.SE `[gmsh]`	`gmsh_examples`	30 votes-sorted
gmsh YouTube	`gmsh_examples`	5 transcripts

{cubit,build123d,gmsh}_examples_refresh() re-scrapes anytime; otherwise cache TTL is 7 days.

Lab stance (Sugawara Lab, 菅原研究室)

Tool	Position
build123d	主力 (push) — new lab work is authored here
Cubit	主力 (push) — hex mesh + visualization
FreeCAD	応援 (friendly) — first-class interop, not first-class authoring; lab respects the FreeCAD community
CadQuery	interop / compat — OCCT sibling
OpenSCAD	interop / compat — legacy scripts

The MCP-tool layer encodes this stance: list_cad_mcp_interop reports primary_pair: "build123d (CAD authoring) + Cubit (hex mesh)" and flags FreeCAD as friendly, others as compat.

External Cubit execution contract

Cubit execution, journals, meshing and process lifetime are owned by cubit-mesh-export's bundled MCP. Radia consumes checked .vol artifacts; it does not own Cubit execution or its test/CI lane. The interop examples below require that separately installed MCP. Mixed omega and other Radia analysis workflows remain in radia-mcp.

Quickstart

build123d → Cubit hex mesh, one call

build123d_to_cubit_hex(
    script=generate_build123d_script("helix_coil")["script"],
    target_size=1.0,
    prefer="hex",
    apply_to_session=True,
)
# ⇒ STEP exported → batch ladder picks scheme auto → persistent headless
#   session reports 1668 hex / 0 tet / 3780 nodes

Safe persistent-session edit

cubit_exec_safely(commands=[
    "volume all size 1.0",
    "volume all scheme tetmesh",
    "mesh volume all",
])
# ⇒ auto-checkpoint → batch dry-run → only on pass: persistent-session mesh
#   if dry-run fails, persistent state is untouched + rollback label returned

Search any layer of knowledge

cubit_ask("hex meshing tutorial")
# ⇒ unioned ranked hits across bundled KB + lab archive (787 files)
#   + Coreform forum + YouTube transcripts

Audit GMSH visualization policy

gmsh_audit_summary("examples")                  # machine-readable policy audit
gmsh_numsubedges_remediation_plan("examples")   # high-order display companions
gmsh_mesh_generation_remediation_plan("examples")
gmsh_reference("all")                           # MSH / API / display reference

Contributing

Bug reports + PRs welcome — particularly for:

Additional scrape sub-sources under radia_mcp.common.examples (mailing list archives, more YouTube channels, blog posts).
Cookbook topics for build123d_usage / gmsh_usage / gmsh_reference — worked-example knowledge fragments are always welcome.

See CONTRIBUTING.md for the lightweight workflow. History of every release is in CHANGELOG.md.

License

BSD-3-Clause — see LICENSE.

Acknowledgments

Coreform for Cubit and the open Discourse forum that we scrape with appreciation.
Roger Maitland (gumyr) for build123d and bd_warehouse — the lab-standard upstream CAD.
Christophe Geuzaine for Gmsh and the open issue tracker on gitlab.onelab.info.
MCP / Anthropic for the protocol that made AI-driven CAE practical.

Release files for radia-mcp 1.5.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for radia-mcp 1.5.3
File	Interpreter	ABI	Platform	Reset
radia_mcp-1.5.3-py3-none-any.whl 6.0 MB Sep 16, 2026	Python 3	none	any	Details

Release files / radia_mcp-1.5.3-py3-none-any.whl

Download URL	radia_mcp-1.5.3-py3-none-any.whl
Size	6.0 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`efc4d08a3d7e20d28c74e60ba0161207421e1e2fce105af0427d8e730826c1c8`
BLAKE2b-256 checksum How to use checksums	`8e02ef4a36ff312076d5c5d67957f145797ac04c06d4bfa3a9d165f873a7a62c`
Upload date	Sep 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ksugahar/Radia
Publishing commit: github.com/ksugahar/Radia/tree/8f7513d54c2cd373b9744fb6acfcf5f883e6f491

Workflow

Publishing configuration: github.com/ksugahar/Radia/blob/8f7513d54c2cd373b9744fb6acfcf5f883e6f491/.github/workflows/radia-mcp-matrix.yml
Publishing logs: github.com/ksugahar/Radia/actions/runs/35069984685/attempts/1

Artifact

Subject: radia_mcp-1.5.3-py3-none-any.whl
SHA-256 checksum: efc4d08a3d7e20d28c74e60ba0161207421e1e2fce105af0427d8e730826c1c8 Verifying attestations