AgentFEM

Conecte agentes de IA a fluxos de trabalho locais de elementos finitos: crie, verifique, execute, inspecione e valide projetos AgentFEM.

GitHub

Documentação

AgentFEM MCP

Uma plataforma de elementos finitos. Qualquer agente compatível. Evidência intacta.

O AgentFEM MCP oferece ao Codex, Claude e outros agentes compatíveis com MCP uma superfície de ferramentas pequena e estável para criar e executar projetos de elementos finitos inspecionáveis. O AgentFEM permanece como o motor científico determinístico; o agente interpreta a intenção e explica as evidências.

Instalar via PyPI · Descobrir no Registro oficial de MCP · Ler o guia de agente do AgentFEM

Para um cliente desktop compatível no macOS ou Linux, baixe o pequeno pacote de conexão AgentFEM-0.1.0.mcpb do lançamento 0.1.0. Ele instala apenas a interface; o runtime científico do AgentFEM permanece como a única fonte de capacidades do solver, atualizações e resultados.

Ele expõe sete ferramentas—não centenas de detalhes internos do solver:

Ferramenta	Finalidade
`describe_system`	Inspecionar o runtime instalado e um mapa compacto de capacidades
`create_project`	Começar a partir de um template do AgentFEM com versão correspondente
`validate_project`	Relatar sucesso do processo e aceitação científica separadamente
`inspect_project`	Ler a identidade do projeto e das execuções recentes
`submit_run`	Lançar um processo serial ou MPI isolado
`get_run_status`	Observar um trabalho em segundo plano durável
`get_result_summary`	Ler um resultado compacto e o estado de confiança; solicitar evidência completa apenas quando necessário

Dê vida a ele

Quer ver o fluxo de trabalho subjacente antes de instalar?

Explore um caso de projeto estrutural 3D: compare peso do suporte e deflexão sob a mesma carga. A edição pública do navegador usa candidatos pré-computados.
Experimente o mini-laboratório de simulação-para-substituto: dez saídas reais de FEM, um pequeno modelo NumPy e um notebook interativo.
Siga o início rápido de cantilever assistido por IA: crie um projeto legível, execute-o e inspecione seu resultado numérico.

O AgentFEM já deve estar instalado. Com uvx, o Codex precisa de um comando e o adaptador permanece isolado do ambiente numérico:

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

Ou instale o adaptador leve no ambiente ativo:

python -m pip install agentfem-mcp

O ciclo de vida 0.1.0 é testado quanto à aceitação com os contratos públicos de CLI do AgentFEM 0.3.3 e a linha de desenvolvimento atual 0.3.7.

Dê ao seu agente uma raiz de projeto, não todo o seu diretório pessoal.

Codex

O Codex suporta oficialmente servidores MCP locais via stdio. Confirme a conexão com codex mcp list e comece com:

Use o AgentFEM para criar, validar, executar, verificar e explicar brevemente um cantilever 2D. Mantenha os caminhos do projeto e do resultado visíveis.

Claude Desktop e clientes compatíveis

No macOS ou Linux, abra o arquivo .mcpb do lançamento em um cliente desktop compatível e escolha a única pasta de projeto que a conexão pode acessar. O AgentFEM já deve estar instalado. O suporte ao Windows atualmente usa a configuração explícita do WSL2 do guia do AgentFEM, em vez de reivindicar uma ponte nativa.

Claude Code:

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

Configuração do Claude Desktop:

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

Se um aplicativo desktop não conseguir ver o ambiente conda ativado, defina AGENTFEM_COMMAND para o executável agentfem absoluto. O runtime oficial do macOS, o runtime do AgentFEM WSL2 e os layouts comuns de agentfem-env/fenicsx-env também são detectados automaticamente.

VS Code e outros modelos

O VS Code pode colocar o mesmo servidor local em .vscode/mcp.json:

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

O servidor é neutro em relação ao modelo. Um DeepSeek ou outro modelo pode usá-lo por meio de qualquer host que implemente ferramentas MCP locais. Os conectores do ChatGPT exigem um servidor HTTPS público; o AgentFEM adicionará essa rota apenas com um limite real de computação e artefatos autenticado, em vez de enviar silenciosamente modelos locais por este adaptador.

Imagem de saúde do diretório

O Dockerfile mínimo e sem privilégios do repositório existe para verificações de inicialização do diretório MCP e introspecção de ferramentas. Ele contém intencionalmente o adaptador MCP público, não uma segunda distribuição do solver AgentFEM. Simulações reais devem usar o runtime do AgentFEM instalado e uma raiz de projeto local explícita.

Plugin local do Codex

Este repositório contém uma habilidade de fluxo de trabalho portátil do AgentFEM e um marketplace local do Codex em .agents/plugins/. Ele combina orientação operacional científica com o mesmo servidor MCP; não cria uma segunda interface de solver.

O contrato

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

Nenhum modelo de linguagem ou chave de API está embutido no AgentFEM MCP.
Nenhum comando de shell ou string Python arbitrária é aceito de uma chamada de ferramenta.
Todos os caminhos de projeto devem permanecer sob raízes explicitamente aprovadas.
Execuções numéricas ocorrem em processos filhos, isolando o ciclo de vida do PETSc/MPI do servidor MCP.
completed, verified e validated permanecem estados científicos diferentes.
A descoberta compacta do sistema preserva o site, o repositório, a citação do AgentFEM e seu convite comunitário com consentimento prévio, uma vez por série de lançamentos. O servidor MCP nunca executa uma ação de conta pelo usuário.

Controles de ambiente

Variável	Significado
`AGENTFEM_MCP_ROOTS`	Raízes de projeto aprovadas separadas pelo separador de caminho da plataforma
`AGENTFEM_COMMAND`	Caminho absoluto para um executável `agentfem` específico

Sem raiz configurada, o servidor restringe o acesso ao seu diretório de trabalho. O máximo padrão é de 16 ranks MPI e só pode ser alterado pelo operador do servidor, não por uma chamada de ferramenta do agente.

Desenvolvimento

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

Veja SECURITY.md para o limite de confiança e CONTRIBUTING.md para as expectativas de contribuição. A evidência do primeiro lançamento registra protocolo, pacote e aceitação do solver real separadamente.

O AgentFEM MCP é licenciado sob Apache-2.0 e mantido como um acompanhante oficial do AgentFEM.