haoming-luo/agentfem-mcp

**One finite-element platform. Any compatible agent. Evidence intact.**
AgentFEM MCP gives Codex, Claude, and other MCP-compatible agents a small,
stable tool surface for building and running inspectable finite-element
projects. AgentFEM remains the deterministic scientific engine; the agent
interprets intent and explains evidence.
Install from PyPI ·
Discover in the official MCP Registry ·
Read the AgentFEM agent guide
For a supported desktop client on macOS or Linux, download the tiny
AgentFEM-0.1.0.mcpb connection bundle from the
0.1.0 release.
It installs only the interface; the AgentFEM scientific runtime remains the
single source of solver capabilities, upgrades, and results.
It exposes seven tools—not hundreds of solver internals:
| Tool | Purpose |
|---|---|
| describe_system | Inspect the installed runtime and a compact capability map |
| create_project | Start from a version-matched AgentFEM template |
| validate_project | Report process success and scientific acceptance separately |
| inspect_project | Read project and recent-run identity |
| submit_run | Launch an isolated serial or MPI process |
| get_run_status | Observe a durable background job |
| get_result_summary | Read a compact result and trust state; request full evidence only when needed |
Bring it to life
Want to see the underlying workflow before installing?
- Explore a 3D structural-design case: compare support weight and deflection under the same load. The public browser edition uses precomputed candidates.
- Try the simulation-to-surrogate mini-lab: ten real FEM outputs, a small NumPy model, and an interactive notebook.
- Follow the AI-assisted cantilever quick start: create a readable project, run it, and inspect its numerical result.
AgentFEM must already be installed. With uvx, Codex needs one command and the
adapter remains isolated from the numerical environment:
Or install the lightweight adapter in the active environment:
The 0.1.0 lifecycle is acceptance-tested with the public AgentFEM 0.3.3 CLI
contracts and the current 0.3.7 development line.
Give your agent a project root, not your whole home directory.
Codex
Codex officially supports local stdio MCP servers. Confirm the connection with
codex mcp list, then begin with:
> Use AgentFEM to create, validate, run, verify, and briefly explain a 2D
> cantilever. Keep the project and result paths visible.
Claude Desktop and compatible clients
On macOS or Linux, open the release's .mcpb file in a supporting desktop
client and choose the one project folder the connection may access. AgentFEM
must already be installed. Windows support currently uses the explicit WSL2
configuration from the AgentFEM guide rather than claiming a native bridge.
Claude Code:
Claude Desktop configuration:
If a desktop app cannot see the activated conda environment, set
AGENTFEM_COMMAND to the absolute agentfem executable. The official macOS
runtime, AgentFEM WSL2 runtime, and common agentfem-env/fenicsx-env layouts
are also detected automatically.
VS Code and other models
VS Code can place the same local server in .vscode/mcp.json: