Open Fem Agent

打开FEM代理

开源 模型上下文协议（MCP）服务器 其将AI编码代理连接到8个独立的有限元代码。任何兼容MCP的AI工具（Claude Code、Cursor、Windsurf、GitHub Copilot）都可以 操作 求解器， 一对 它们跨越代码，以及 开发 新的求解器功能——全部通过一个协议实现。

关键数字

快速开始

1.克隆并安装

git clone  && cd open-fem-agent
python3 -m venv .venv && source .venv/bin/activate
pip install -e .

2.安装求解器后端（选择所需内容）

# pip-installable (any combination)
pip install ngsolve scikit-fem dune-fem
pip install KratosMultiphysics KratosStructuralMechanicsApplication

# FEniCSx (requires conda)
conda create -n fenics -c conda-forge fenics-dolfinx
# or: pip install fenics-dolfinx (if available for your platform)

# deal.II (system package)
sudo apt install libdeal.ii-dev   # Ubuntu/Debian

# 4C Multiphysics (build from source — see 4C documentation)

3.连接到您的AI工具

MCP服务器作为stdio进程运行。每个AI工具都有自己的注册方式。

克劳德代码 （推荐--支持评论家工作流的子代理生成）：

# From the project root:
claude mcp add open-fem-agent \
  .venv/bin/python -- -m server \
  -e PYTHONPATH=src \
  -e PYVISTA_OFF_SCREEN=true

或手动创建 .claude/settings.json 在项目目录中：

{
  "mcpServers": {
    "open-fem-agent": {
      "type": "stdio",
      "command": ".venv/bin/python",
      "args": ["-m", "server"],
      "cwd": "src",
      "env": {
        "PYTHONPATH": "src",
        "PYVISTA_OFF_SCREEN": "true"
      }
    }
  }
}

光标:

前往“设置”>“MCP服务器”>“添加服务器”，然后输入：

• 姓名： open-fem-agent
• 命令： /path/to/open-fem-agent/.venv/bin/python
• Args： -m server
• 工作目录： /path/to/open-fem-agent/src
• 环境： PYTHONPATH=src, PYVISTA_OFF_SCREEN=true

帆板运动:

添加到您的Windsurf MCP配置中（设置>MCP）：

{
  "open-fem-agent": {
    "command": "/path/to/open-fem-agent/.venv/bin/python",
    "args": ["-m", "server"],
    "cwd": "/path/to/open-fem-agent/src",
    "env": { "PYTHONPATH": "src", "PYVISTA_OFF_SCREEN": "true" }
  }
}

OpenAI Codex/任何MCP客户端:

服务器通过stdio与标准MCP通信。为您的客户指出：

command: .venv/bin/python -m server
cwd: src/
env: PYTHONPATH=src

4.验证

source .venv/bin/activate
cd src && python -m server  # should start without errors (Ctrl+C to stop)

# Run tests
cd .. && pytest tests/ -v

5.可选：配置求解器源访问

要启用开发人员模式（源代码浏览、修改、重建），请将求解器路径添加到MCP环境中。看 .claude/settings.json.example 对于模板。

环境变量

从pip/conda安装中自动检测求解器后端。对于编译的求解器或源代码级开发访问，请在MCP设置中设置这些：

当a *_ROOT 设置变量后，代理可以浏览、修改和重建求解器源代码（开发人员模式）。

建筑

User --> AI Agent (any MCP client) --> MCP Protocol --> Open FEM Agent
                                                          |
                  +-------------+-------------+-----------+--------+--------+--------+
                  |             |             |           |        |        |        |
               FEniCSx      deal.II        4C        NGSolve  skfem    Kratos   DUNE
              (Python)       (C++)       (YAML)     (Python) (Python) (JSON)  (Python)

三种操作模式

1.操作：运行模拟

代理生成求解器特定的输入，运行模拟并验证结果。

2.耦合：多求解器工作流

不同有限元代码之间的域分解、场传递和多物理场耦合。

3.开发：扩展求解能力

当求解器缺少所需的功能时，代理可以读取源代码、实现缺失的部分、重建和测试。

MCP工具

测试基准

这些基准测试是使用新的人工智能代理进行的端到端压力测试。每个提示都逐字逐句地提供给代理人，没有额外的指导。

单解算器基准测试（9/9通过）

交叉求解器验证（2/2通过）

多求解器耦合（4/4通道）

高级（7/7通过）

求解器选择和代理智能（1/1通过）

贡献

我们欢迎改善 多用途的 Open FEM Agent的功能。关键原则：

每一项改进都必须使所有模拟受益，而不是针对特定示例进行微调。

如何做出贡献

1. 报告代理行为 --使用AI工具和求解器设置运行任何基准测试提示（或您自己的）。报告：

- 你使用了哪种人工智能工具（克劳德代码、光标、风帆等） - 你给出的确切提示 - 什么有效，什么无效 - 代理人的回顾（问下面的汇报问题）

1. 提高求解器知识 -添加陷阱、元素目录或API文档，以帮助任何代理正确设置模拟。专注于代理人必须通过反复试验发现的事情。

1. 添加求解器后端 --实施 SolverBackend 新FEM代码的接口。

1. 膨胀联轴器 --在中为新的求解器对添加脚本生成器 src/tools/coupling.py.

什么不该贡献

• 基准特定参数数据库（代理应针对每个问题进行研究）
• 特定于模型的模板（例如“Turek Hron FSI2模板”）——这些是微调
• 硬编码路径或机器特定配置

汇报问题（每次压力测试后提问）

- "What went wrong and what workarounds did you have to use?"
- "Which MCP tools were useful and which were missing or unhelpful?"
- "What information did you have to look up online that should have been available through the MCP?"
- "What parameters did you struggle with and why?"
- "If you had to do this again, what would you do differently?"

将答案反馈为对MCP知识和工具的通用改进。

AI工具兼容性

MCP服务器可与任何兼容MCP的AI工具配合使用。代理指令以多种格式提供：

许可证

麻省理工学院

引用

如果您在研究中使用Open FEM Agent，请引用：

@article{openfem2026,
  title={Open FEM Agent: An Open-Source Multi-Solver MCP Server for LLM-Driven Finite Element Simulation},
  year={2026},
}