AgentFEM MCP 是 AgentFEM 的官方 MCP（Model Context Protocol）接口，面向 Codex、Claude 以及其他兼容 MCP 的智能体，提供一套小而稳定的工具面，用于构建和运行可检查的有限元项目。其核心理念是：AgentFEM 保持为确定性的科学引擎，智能体负责解释用户意图并说明证据。
用途 该接口让兼容 MCP 的智能体能够创建、验证、运行、检查和核验有限元仿真。它只暴露七个工具，而不是数百个求解器内部细节，从而降低智能体调用复杂度，同时保持科学计算的可追溯性。
主要能力
- 创建、验证、运行、检查、核验有限元仿真项目。
- 与 Codex、Claude Desktop 及其他 MCP 兼容客户端集成。
- 支持通过 PyPI 安装，也可在官方 MCP Registry 中发现。
- 提供 macOS 或 Linux 桌面客户端的 .mcpb 连接包（0.1.0 版本），仅安装接口，科学运行时仍由 AgentFEM 提供。
- 仓库包含可移植的 AgentFEM 工作流技能和本地 Codex 市场（位于 .agents/plugins/），结合科学操作指南与同一 MCP 服务器，不创建第二个求解器接口。
- 提供最小化、非特权 Dockerfile，用于 MCP 目录启动和工具自省检查；该镜像仅含公开 MCP 适配器，不含第二个 AgentFEM 求解器发行版。
使用方式 使用前必须已安装 AgentFEM。
- 通过 uvx 安装：Codex 只需一条命令，适配器与数值环境隔离。
- 或在当前环境中安装轻量适配器。
- Codex 官方支持本地 stdio MCP 服务器，可用 codex mcp list 确认连接。
- Claude Desktop 及兼容客户端：在 macOS 或 Linux 上，用支持的桌面客户端打开发布版的 .mcpb 文件，并选择连接可访问的一个项目文件夹。Windows 目前使用 AgentFEM 指南中的显式 WSL2 配置，而非原生桥接。
- 若桌面应用无法看到已激活的 conda 环境，可将 AGENTFEM_COMMAND 设为 agentfem 可执行文件的绝对路径。官方 macOS 运行时、AgentFEM WSL2 运行时以及常见的 agentfem-env / fenicsx-env 布局也会被自动检测。
- VS Code 及其他模型：可将同一本地服务器放入 .vscode/mcp.json。服务器与模型无关，DeepSeek 或其他模型可通过任何实现本地 MCP 工具的主机使用。ChatGPT 连接器需要公开 HTTPS 服务器；AgentFEM 仅在具备真实认证的计算与产物边界时才会添加该路由，而不会通过此适配器静默上传本地模型。
- 建议给智能体一个项目根目录，而不是整个主目录。
适用场景
- 需要由智能体辅助完成有限元仿真创建、运行与结果核验的科研或工程工作流。
- 希望保持科学计算确定性、证据完整，同时让智能体解释意图和证据的场景。
- 使用 Codex、Claude Desktop、VS Code 等支持本地 MCP 工具的客户端。
- 可参考仓库中的示例：3D 结构设计案例（比较同一载荷下支撑重量与挠度，公开浏览器版使用预计算候选）、仿真到代理模型迷你实验室（十个真实 FEM 输出、小型 NumPy 模型和交互式 notebook）、AI 辅助悬臂梁快速入门（创建可读项目、运行并检查数值结果）。
限制
- AgentFEM 必须已安装，MCP 接口本身不包含求解器。
- 不内嵌语言模型或 API 密钥。
- 不接受来自工具调用的 shell 命令或任意 Python 字符串。
- 所有项目路径必须位于明确批准的根目录下。
- 数值运行在子进程中进行，以隔离 PETSc/MPI 生命周期与 MCP 服务器。
- completed、verified、validated 是不同科学状态。
- 未配置根目录时，服务器仅限访问其工作目录。默认最大 MPI 进程数为 16，且只能由服务器操作者更改，智能体工具调用无法更改。
- 0.1.0 生命周期已针对公开的 AgentFEM 0.3.3 CLI 契约和当前 0.3.7 开发线进行验收测试。
- Windows 原生支持暂未提供，目前使用 WSL2 配置。
- ChatGPT 连接器所需的公开 HTTPS 服务器路由暂未提供。
- 采用 Apache-2.0 许可，作为 AgentFEM 的官方配套项目维护。
