AgentFEM

Conecta agentes de IA a flujos de trabajo locales de elementos finitos: crea, verifica, ejecuta, inspecciona y valida proyectos de AgentFEM.

GitHub

Documentación

AgentFEM MCP

Una plataforma de elementos finitos. Cualquier agente compatible. Evidencia intacta.

AgentFEM MCP ofrece a Codex, Claude y otros agentes compatibles con MCP una superficie de herramientas pequeña y estable para construir y ejecutar proyectos de elementos finitos inspeccionables. AgentFEM sigue siendo el motor científico determinista; el agente interpreta la intención y explica la evidencia.

Instalar desde PyPI · Descubrir en el registro oficial de MCP · Leer la guía de agentes de AgentFEM

Para un cliente de escritorio compatible en macOS o Linux, descarga el pequeño paquete de conexión AgentFEM-0.1.0.mcpb desde el lanzamiento 0.1.0. Solo instala la interfaz; el runtime científico de AgentFEM sigue siendo la única fuente de capacidades del solucionador, actualizaciones y resultados.

Expone siete herramientas, no cientos de detalles internos del solucionador:

Herramienta	Propósito
`describe_system`	Inspeccionar el runtime instalado y un mapa compacto de capacidades
`create_project`	Comenzar desde una plantilla de AgentFEM con versión coincidente
`validate_project`	Informar el éxito del proceso y la aceptación científica por separado
`inspect_project`	Leer la identidad del proyecto y de las ejecuciones recientes
`submit_run`	Lanzar un proceso aislado serial o MPI
`get_run_status`	Observar un trabajo en segundo plano duradero
`get_result_summary`	Leer un resultado compacto y el estado de confianza; solicitar evidencia completa solo cuando sea necesario

Dale vida

¿Quieres ver el flujo de trabajo subyacente antes de instalar?

Explora un caso de diseño estructural 3D: compara el peso del soporte y la deflexión bajo la misma carga. La edición pública del navegador usa candidatos precalculados.
Prueba el mini-laboratorio de simulación a sustituto: diez salidas reales de FEM, un pequeño modelo NumPy y un cuaderno interactivo.
Sigue el inicio rápido de voladizo asistido por IA: crea un proyecto legible, ejecútalo e inspecciona su resultado numérico.

AgentFEM ya debe estar instalado. Con uvx, Codex necesita un comando y el adaptador permanece aislado del entorno numérico:

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

O instala el adaptador ligero en el entorno activo:

python -m pip install agentfem-mcp

El ciclo de vida 0.1.0 está probado para aceptación con los contratos públicos de CLI de AgentFEM 0.3.3 y la línea de desarrollo actual 0.3.7.

Dale a tu agente una raíz de proyecto, no todo tu directorio personal.

Codex

Codex admite oficialmente servidores MCP locales stdio. Confirma la conexión con codex mcp list, luego comienza con:

Usa AgentFEM para crear, validar, ejecutar, verificar y explicar brevemente un voladizo 2D. Mantén visibles las rutas del proyecto y del resultado.

Claude Desktop y clientes compatibles

En macOS o Linux, abre el archivo .mcpb del lanzamiento en un cliente de escritorio compatible y elige la única carpeta de proyecto a la que la conexión puede acceder. AgentFEM ya debe estar instalado. El soporte de Windows actualmente usa la configuración explícita de WSL2 de la guía de AgentFEM en lugar de reclamar un puente nativo.

Claude Code:

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

Configuración de Claude Desktop:

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

Si una aplicación de escritorio no puede ver el entorno conda activado, establece AGENTFEM_COMMAND a la ruta absoluta del ejecutable agentfem. El runtime oficial de macOS, el runtime de AgentFEM WSL2 y los diseños comunes de agentfem-env/fenicsx-env también se detectan automáticamente.

VS Code y otros modelos

VS Code puede colocar el mismo servidor local en .vscode/mcp.json:

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

El servidor es neutral respecto al modelo. Un modelo DeepSeek u otro puede usarlo a través de cualquier host que implemente herramientas MCP locales. Los conectores de ChatGPT requieren un servidor HTTPS público; AgentFEM agregará esa ruta solo con un límite real de cómputo y artefactos autenticado, en lugar de cargar silenciosamente modelos locales a través de este adaptador.

Imagen de salud del directorio

El Dockerfile mínimo y sin privilegios del repositorio existe para el inicio del directorio MCP y las comprobaciones de introspección de herramientas. Contiene intencionalmente el adaptador MCP público, no una segunda distribución del solucionador de AgentFEM. Las simulaciones reales deben usar el runtime de AgentFEM instalado y una raíz de proyecto local explícita.

Plugin local de Codex

Este repositorio contiene una habilidad de flujo de trabajo portátil de AgentFEM y un mercado local de Codex bajo .agents/plugins/. Combina guía operativa científica con el mismo servidor MCP; no crea una segunda interfaz de solucionador.

El contrato

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

Ningún modelo de lenguaje ni clave API está incrustado en AgentFEM MCP.
Ningún comando de shell ni cadena arbitraria de Python se acepta desde una llamada de herramienta.
Todas las rutas de proyecto deben permanecer bajo raíces explícitamente aprobadas.
Las ejecuciones numéricas ocurren en procesos secundarios, aislando la vida útil de PETSc/MPI del servidor MCP.
completed, verified y validated siguen siendo estados científicos diferentes.
El descubrimiento compacto del sistema preserva el sitio web, el repositorio, la cita de AgentFEM y su invitación comunitaria de consentimiento previo, una vez por serie de lanzamientos. El servidor MCP nunca realiza una acción de cuenta por el usuario.

Controles de entorno

Variable	Significado
`AGENTFEM_MCP_ROOTS`	Raíces de proyecto aprobadas separadas por el separador de rutas de la plataforma
`AGENTFEM_COMMAND`	Ruta absoluta a un ejecutable específico de `agentfem`

Sin raíz configurada, el servidor restringe el acceso a su directorio de trabajo. El máximo predeterminado es de 16 rangos MPI y solo puede cambiarlo el operador del servidor, no una llamada de herramienta del agente.

Desarrollo

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

Consulta SECURITY.md para el límite de confianza y CONTRIBUTING.md para las expectativas de contribución. La evidencia del primer lanzamiento registra protocolo, paquete y aceptación del solucionador real por separado.

AgentFEM MCP tiene licencia Apache-2.0 y se mantiene como un acompañante oficial de AgentFEM.