AgentFEM

AgentFEM MCP

一个有限元平台。适用于任何兼容的 Agent。证据完整保留。

AgentFEM MCP 为 Codex、Claude 和其他兼容 MCP 的 Agent 提供简洁、稳定的工具接口，用于构建和运行可检查的有限元项目。AgentFEM 仍是确定性的科学引擎；Agent 负责解读意图并说明证据。

从 PyPI 安装 · 在官方 MCP Registry 中发现 · 阅读 AgentFEM Agent 指南

对于 macOS 或 Linux 上受支持的桌面客户端，请从 0.1.0 版本 下载轻量级的 AgentFEM-0.1.0.mcpb 连接包。它只安装接口；AgentFEM 科学运行时仍是求解器功能、升级和结果的唯一来源。

它提供七个工具，而不是数百个求解器内部接口：

工具	用途
describe_system	检查已安装的运行时和精简的功能概览
create_project	从版本匹配的 AgentFEM 模板开始
validate_project	分别报告进程是否成功和科学验收是否通过
inspect_project	查看项目和最近一次运行的身份信息
submit_run	启动隔离的串行或 MPI 进程
get_run_status	查看持久化的后台任务
get_result_summary	查看精简的结果和可信状态；仅在需要时请求完整证据

启动体验

想在安装前先了解底层工作流吗？

• 探索 3D 结构设计案例：在相同载荷下比较支撑重量和挠度。公开的浏览器版本使用预先计算的候选方案。
• 体验从模拟到代理模型的迷你实验室：十个真实 FEM 输出、一个小型 NumPy 模型和一个交互式笔记本。
• 跟随 AI 辅助悬臂梁快速入门：创建易读的项目、运行项目并检查数值结果。

必须预先安装 AgentFEM。使用 uvx 时，Codex 只需一条命令，适配器也会与数值环境隔离：

codex mcp add agentfem \
  --env AGENTFEM_MCP_ROOTS=/absolute/path/to/AgentFEMProjects \
  -- uvx --from agentfem-mcp agentfem-mcp

或者在当前活动环境中安装轻量级适配器：

python -m pip install agentfem-mcp

0.1.0 版本生命周期已通过公开的 AgentFEM 0.3.3 CLI 合约和当前的 0.3.7 开发线进行验收测试。

为 Agent 提供项目根目录，而不是整个主目录。

Codex

Codex 正式支持本地 stdio MCP 服务。使用 codex mcp list 确认连接，然后从以下提示开始：

使用 AgentFEM 创建、验证、运行并核验一个二维悬臂梁，并简要说明。让项目和结果路径保持可见。

Claude Desktop 和兼容客户端

在 macOS 或 Linux 上，在支持的桌面客户端中打开该版本的 .mcpb 文件，并选择连接可访问的一个项目文件夹。必须已安装 AgentFEM。Windows 目前使用 AgentFEM 指南中明确说明的 WSL2 配置，而非声称支持原生桥接。

Claude Code：

claude mcp add agentfem --scope user \
  --env AGENTFEM_MCP_ROOTS=/absolute/path/to/AgentFEMProjects \
  -- uvx --from agentfem-mcp agentfem-mcp

Claude Desktop 配置：

{
  "mcpServers": {
    "agentfem": {
      "command": "agentfem-mcp",
      "env": {
        "AGENTFEM_MCP_ROOTS": "/absolute/path/to/AgentFEMProjects"
      }
    }
  }
}

如果桌面应用无法看到已激活的 conda 环境，请将 AGENTFEM_COMMAND 设为 agentfem 可执行文件的绝对路径。官方 macOS 运行时、AgentFEM WSL2 运行时，以及常见的 agentfem-env/fenicsx-env 布局也会被自动检测。

VS Code 和其他模型

VS Code 可以在 .vscode/mcp.json 中配置相同的本地服务：

{
  "servers": {
    "agentfem": {
      "type": "stdio",
      "command": "uvx",
      "args": ["--from", "agentfem-mcp", "agentfem-mcp"],
      "env": {
        "AGENTFEM_MCP_ROOTS": "${workspaceFolder}"
      }
    }
  }
}

该服务与模型无关。DeepSeek 或其他模型可通过任何实现本地 MCP 工具的宿主使用它。ChatGPT 连接器需要公共 HTTPS 服务；只有在具备真正经过身份验证的计算和产物边界时，AgentFEM 才会添加该接入方式，而不会通过此适配器悄悄上传本地模型。

目录健康检查镜像

仓库中的精简、非特权 Dockerfile 用于 MCP 目录启动和工具自检。它有意仅包含公共 MCP 适配器，不包含第二套 AgentFEM 求解器发行版。实际模拟应使用已安装的 AgentFEM 运行时和明确指定的本地项目根目录。

本地 Codex 插件

此仓库在 .agents/plugins/ 下包含一个可移植的 AgentFEM 工作流技能和一个本地 Codex 插件市场。它将科学操作指南与相同的 MCP 服务结合起来；不会创建第二种求解器接口。

使用约定

AI agent
   │  seven typed MCP tools
   ▼
AgentFEM MCP ── process + path boundary
   │  versioned JSON contracts
   ▼
AgentFEM CLI → Study → Model → Step → SimulationResult
   ▼
FEniCSx / PETSc / MPI

• AgentFEM MCP 中不嵌入任何大模型或 API 密钥。
• 工具调用不接受任何 shell 命令或任意 Python 字符串。
• 所有项目路径都必须位于明确批准的根目录下。
• 数值计算在子进程中运行，将 PETSc/MPI 的生命周期与 MCP 服务隔离。
• completed、verified 和 validated 仍代表不同的科学状态。
• 精简的系统信息发现功能会保留 AgentFEM 的网站、代码仓库、引用信息，以及遵循知情同意原则、每个发布系列仅邀请一次的社区邀请。MCP 服务绝不会代用户执行账户操作。

环境控制项

变量	含义
AGENTFEM_MCP_ROOTS	使用平台路径分隔符分隔的已批准项目根目录
AGENTFEM_COMMAND	指定 agentfem 可执行文件的绝对路径

未配置根目录时，服务会将访问限制在其工作目录内。默认最大进程数为 16，且只能由服务运营者更改，不能通过 Agent 工具调用更改。

开发

python -m pip install -e '.[test]'
ruff check .
pytest
python -m build

有关信任边界，请参阅 SECURITY.md；有关贡献要求，请参阅 CONTRIBUTING.md。 first release evidence 分别记录了协议、软件包和真实求解器的验收情况。

AgentFEM MCP 采用 Apache-2.0 许可证，并作为 AgentFEM 的官方配套项目维护。