FEA (finite element analysis)

io.github.TheRoboMaster123Published by GitHub account TheRoboMaster123v1.0.0Updated Oct 25, 2026

Real FEA on CAD parts: validated setups, stress, safety factor, natural frequencies

VerifiedStreamable HTTPWeb executableDeveloper ToolsData & Analytics

Overview

AI-generated overview

Remote MCP server that runs real finite element analysis on STEP CAD parts, returning stress, safety factor, deflection and natural frequencies.

What you can do
Inspect a STEP part and get its face table, bounding box and volume so loads and constraints can be mapped to face ids, and list the built-in material library with elastic properties and yield strengths. Submit a linear static study that validates, meshes and solves the part, returning peak von Mises stress, factor of safety, deflection, stress plots and a 3D viewer payload. Submit a modal study for natural frequencies and mode shapes with exaggerated-deformation images. Retrieve the full report of a completed task, including optional surface-mesh data.
When to use it
Useful when you want a quick engineering sanity check on a single solid CAD part from a conversation, such as whether a bracket survives a given load or what its first natural frequency is, without setting up a solver yourself.
Requirements
A remote streamable HTTP endpoint; no local install. A bearer token issued by the operator, sent in the Authorization header. STEP files must be under 25 MB and a single solid body. Network access to the hosted endpoint.
Before you install
The Authorization bearer token is a secret and must be kept private. Each study runs compute on the operator's Modal deployment and is billed to them, so rate, concurrency and daily budget limits apply. Results are linear static or modal only and are flagged untrusted when the reaction-balance check fails; post-yield and large-deflection results are warnings, not validated designs. Uploaded CAD geometry is sent to a third-party hosted service.

Installation

In SourceWeft

  1. Open FEA (finite element analysis) in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.TheRoboMaster123%2Fmcp-fea/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "fea-finite-element-analysis": {
      "type": "http",
      "url": "https://therobomaster123--mcp-fea-mcp-endpoint.modal.run/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

mcp-fea

[ci] [validation] [license] [MCP]

Real finite element analysis from a conversation. An AI assistant sends a STEP file and a plain-English question ("does this arm survive a 6 g maneuver with a 400 g motor?"); this MCP server maps the words onto geometry, rejects bad setups deterministically before any compute is spent, meshes and solves with CalculiX on Modal as an async MCP task, and returns a verdict backed by numbers — peak von Mises stress, factor of safety, deflection, natural frequencies — plus rendered stress plots and an interactive 3D viewer. Every study ends with a non-skippable reaction-balance check; every benchmark on the validation page is regenerated by CI on every commit.

[mode 1 animation]

Measured on the live deployment (2026-07-31): cold start 3.8 s · cantilever study submit→completed 9.3 s warm / 12.9 s with a cold solver container · ~$0.002 per study at Modal's posted rates.

BenchmarkReferenceComputedError
Cantilever tip deflection (PL³/3EI)0.58055 mm0.58046 mm0.02%
NAFEMS LE10 σ_yy @ D−5.38 MPa−5.456 MPa1.41%
Plate-with-hole peak (Heywood Kt)62.8 MPa61.92 MPa1.40%
Cantilever f₁ (Euler–Bernoulli)816.0 Hz815.4 Hz0.08%

Full table, mesh stats, and an explicit limitations section: docs/validation.md — regenerated by CI, never hand-edited.

Protocol: MCP 2026-07-28 (stateless core) with the io.modelcontextprotocol/tasks extension implemented per SEP-2663 (the official Python SDK v2 shipped without it — this repo also contains the client-side extension that teaches the official SDK to consume task-augmented servers) and an MCP Apps (SEP-1865) 3D viewer. See docs/decisions.md for every engineering call and why.

Deploy (3 commands)

bash
uv syncuv run modal secret create mcp-fea-token MCP_FEA_TOKEN=$(openssl rand -hex 24)uv run modal deploy -m src.server.modal_app

Modal prints the endpoint URL (https://<workspace>--mcp-fea-mcp-endpoint.modal.run). Connect any 2026-07-28 MCP client with Authorization: Bearer <your token>. First-time Modal users: uv run modal token new once. Then verify the live deployment end to end:

bash
MCP_FEA_LIVE_URL=https://... MCP_FEA_TOKEN=... make verify-live

Tools

ToolSync/asyncWhat it does
inspect_geometrysyncSTEP → face table (face_id, type, centroid, normal/axis, area, bbox) + part bbox/volume. Call first: it's how English maps to face ids.
list_materialssyncBuilt-in library: Al 6061-T6, Al 7075-T6, Steel 4140, Stainless 304, Ti-6Al-4V, ABS, PLA, Nylon 12, PC (E, ν, yield, density).
submit_fea_studytaskLinear static: validate → mesh (C3D10, curvature-adaptive, local thin-wall refine) → CalculiX → verdict/stress/FoS + 3 stress PNGs.
submit_modal_studytaskNatural frequencies + mode shapes (*FREQUENCY), first N modes (default 6), one exaggerated-deformation PNG per mode. Requires constraints and density.
get_reportsyncFull payload for a completed task; include_mesh_data: true adds the surface-mesh payload the 3D viewer app fetches.

Task lifecycle: working (statusMessage walks validating → meshing → solving → postprocessing) → completed | failed | cancelled; tasks/cancel kills the running container. Tasks are retained 24 h.

Units policy

One conversion boundary, at ingest. Internally everything is consistent mm–N–MPa(–tonne): lengths mm, forces N, stress/moduli MPa, density tonne/mm³ (kg/m³ × 1e-12 — done once, in Material.density_tonne_mm3), which makes modal frequencies come out directly in Hz. STEP coordinates are interpreted in the declared units (mm|m|in); gmsh's own unit conversion is disabled so the declared unit is authoritative — and sanity-checked (a 100 mm part declared "m" gets flagged).

Validation codes

Every rejection returns {code, message, suggested_fix}.

CodeMeaningStage
GEOMETRY_REF_INVALIDSTEP missing/unreadable/over 25 MB, bad units fieldparse
GEOMETRY_KERNEL_CRASH / GEOMETRY_TIMEOUTCAD kernel crashed / hung on the file (isolated subprocess; endpoint unaffected)inspect
MATERIAL_UNKNOWN / MATERIAL_UNPHYSICALNot in library / E ∉ [0.01, 1500] GPa, ν ∉ (0, 0.5), yield ≤ 0, density ∉ [10, 25000] kg/m³, missing density for modalparse
CONSTRAINT_INVALID / CONSTRAINT_CONFLICTBad type; node pinned in two local framesparse/deck
LOAD_INVALID / LOAD_MISSING / MODAL_INVALIDBad type/units/direction; zero loads; bad n_modesparse
GEOM_NO_SOLID / GEOM_MULTIPLE_SOLIDSNot a single solid body (assemblies = v2)pre-mesh
FACE_ID_INVALIDFace id not on this partpre-mesh
RIGID_BODY_MOTIONConstraints leave free motion (named, e.g. "rotation about the hole axis") — SVD rank checkpre-mesh
LOAD_ON_FIXED_FACELoad applied to a fully fixed facepre-mesh
UNITS_SUSPECT (warning)Part > 5 m or < 0.5 mm — declared units probably wrongpre-mesh
LOAD_MAGNITUDE_EXTREME / _NEGLIGIBLE (warnings)σ ≈ F/A > 10× yield or < 1e-6× yieldpre-mesh
MESH_ELEMENT_CAP> 400k elements even after coarsening / local refinemesh
MESH_QUALITY_JACOBIAN / MESH_QUALITY_ASPECT / MESH_THIN_WALLSQuality gates; thin walls get one local auto-refine firstmesh
MESH_TIMEOUTMeshing exceeded its wall budget (near-tangent slivers, helical threads) — the worker is killed from outsidemesh
SOLVER_SINGULAR / SOLVER_MESH_DEGENERATE / SOLVER_TIMEOUT / SOLVER_FAILEDMapped ccx failures (>150k elements auto-switch to the iterative solver)solve
EQUILIBRIUM_FAIL (warning, untrusted result)ΣRF vs free-node applied loads off by > 0.5%post
LOAD_INTO_SUPPORT (warning)> 5% of the load lands on constrained nodes (loaded face touches a fixed face) and is carried directly by the supportpost
BEYOND_YIELD / LARGE_DEFLECTION (warnings)FoS < 1 (post-yield numbers flagged non-physical) / u > 5% of min dimensionpost

Abuse limits (all env-tunable)

25 MB STEP cap · 40 MB request cap (413) · per-token rate limit (MCP_FEA_RATE_LIMIT/_WINDOW_S, 429) · concurrent-solve cap (MCP_FEA_MAX_CONCURRENT) · daily budget (MCP_FEA_MAX_SPAWNS_PER_DAY) · kill switch (MCP_FEA_DISABLE_SPAWN=1). CAD parsing never runs in the endpoint process (see SECURITY.md).

Local development

bash
uv synccurl -Ls https://micro.mamba.pm/api/micromamba/osx-arm64/latest | tar -xj bin/micromamba./bin/micromamba create -y -p .tools/ccx-env -c conda-forge calculix=2.23make test        # fast suite (protocol, benchmarks, validation, hardening)make torture     # 21 real-world STEP files through the endpointmake validation-pageuv run uvicorn --factory src.server.app:create_local_app --port 8000  # local server

Repo map

src/pipeline/ geometry, meshing, deck, solver, validation, post, render · src/materials/ library · src/server/ protocol, tools, tasks, limits, worker host, Modal app, Apps UI · src/client/ SDK tasks extension · tests/ (incl. torture/) · demo/ · docs/ decisions, validation, upstream notes. License: Apache-2.0.

Source: README.md at commit f11fe6a

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts