GX Works Agent
Servidor MCP stdio para Windows, voltado à engenharia de CLPs Mitsubishi GX Works2. Fornece contexto manual com escopo de CPU, inspeção e diagnóstico de projetos, edição de Ladder/FBD e artefatos de projeto com versionamento, utilizando o modelo de IA fornecido pelo cliente MCP.
Documentação
GXWorks Agent
Ferramentas MCP e um ambiente de trabalho de IA para engenharia de PLCs Mitsubishi.
Leia o contexto do projeto. Construa e revise programas. Entregue ao GX Works2.
Downloads · MCP & Web · Issues
Início rápido · Ladder · ST · FBD · Web · Diagnóstico
O GXWorks Agent suporta fluxos de trabalho com Ladder, Texto Estruturado (ST) e FBD nativo. Ele fornece a agentes externos contexto do projeto, instruções específicas da CPU, evidências de manuais e ferramentas de engenharia por meio do MCP. Conecte-se via MCP, use seu próprio modelo e salve artefatos de engenharia versionados. O runtime MCP padrão funciona de forma independente; o ambiente de trabalho Web é opcional.
Ladder: do contexto de engenharia a um programa salvo
Um exemplo de esteira com FX3U: recupere o contexto para WSFL, INC e T200, construa um candidato em Ladder e salve-o via MCP. Fatos estruturados de instruções e evidências de manuais informam o candidato; a versão salva inclui JSON do Ladder, IR, SVG, ST derivado do IR e CSVs de importação para GX.
O GIF visualiza resultados reais do SDK/MCP e artefatos gerados. O assistente construiu o candidato a partir do contexto retornado; isso não é uma gravação de um modelo embarcado rodando de forma autônoma.
ST: gere e revise Texto Estruturado
O ST tem seu próprio fluxo de geração no ambiente de trabalho Web: analise o requisito, confirme a especificação e gere program.st usando o contexto de instruções da CPU selecionada e as assinaturas de ST. Visualize o candidato, inspecione diferenças de texto entre versões e salve o artefato ST. Programas em Ladder também podem exportar ST rastreável a partir do IR do PLC.
A inspeção local de ST verifica a sintaxe e a semântica suportadas e relata construções não suportadas. É um parser limitado, não o compilador do GX Works2; a compilação nativa e o comportamento do PLC permanecem separados. O MCP pode fornecer contexto de ST e diagnósticos existentes, enquanto create_program_candidate atualmente aceita candidatos em Ladder.
O que a API oferece
- Contexto vinculado ao projeto. Crie ou selecione um projeto, leia sua CPU e o programa atual, descubra instruções aplicáveis e interfaces chamáveis e continue a partir de uma versão salva.
- RAG de engenharia. Fatos de instruções com escopo de CPU e trechos de manuais carregam referências de fonte. A arquitetura de recuperação combina entidade, texto completo e recuperação densa/LSA com fusão de classificação; fatos estruturados cobrem detalhes conhecidos de instruções, enquanto a recuperação residual fornece evidências de apoio.
- Edição de candidatos e artefatos. Envie alterações em Ladder ou FBD por meio de ferramentas de engenharia compartilhadas. O núcleo verifica a estrutura e os operandos suportados, prepara artefatos e retorna resultados vinculados à versão. Salvamento local, compilação nativa e verificação de comportamento têm resultados separados.
- Entrega ao GX Works2. Com consentimento de execução configurado pelo operador, importe o MAIN e os comentários de dispositivos da versão atual do Ladder e receba o resultado da operação nativa. A ponte Web opcional mantém a revisão no ambiente de trabalho.
Seu cliente ou estrutura fornece o modelo e o loop de planejamento. O GXWorks Agent fornece o contexto de engenharia, as ferramentas, a persistência e os recibos de operação.
GUI Web: inspecione e exporte um programa
Configure uma API de modelo diretamente no ambiente de trabalho e use o fluxo de geração Direta integrado; em seguida, inspecione redes de programa, endereços de dispositivos e exportações disponíveis. A geração Direta pode reduzir a sobrecarga de orquestração de agentes externos; o uso real de tokens depende do modelo e da tarefa. Ela compartilha o pipeline de contexto de engenharia com o MCP, e a resposta a perguntas no ambiente de trabalho ainda pode envolver loops de ferramentas.
FBD: edite um projeto GXW existente
Adicione travamento de falha, reset e um atraso de habilitação de 500 ms ao primeiro eixo do exemplo MotionControl JEC da Mitsubishi Electric. A edição preserva as implementações de FB existentes e a fiação do Eixo IN_OUT, adiciona lógica SR/TON e conecta a permissão ao bloco de controle de energia existente.
Fonte: Exemplo MotionControl JEC da Mitsubishi Electric.
O FBD vai além da alteração de fiação da demonstração. Gere ou edite candidatos a partir de um projeto inicial ou de um GXW importado; adicione, altere ou remova objetos, conexões, declarações e múltiplas redes; use interfaces de FB de projeto/biblioteca e parâmetros IN_OUT; e inspecione visualizações gráficas, diferenças de versão e artefatos GXW.
Onde o projeto de origem suportar, crie FBs e Programas. Um novo Programa pode ser registrado em uma tarefa existente, em uma nova tarefa ou em um novo recurso. Salvamento nativo, compilação e verificação de código são operações separadas, com resultados vinculados à versão correspondente do projeto.
Gerenciamento de projetos, diagnóstico e validação
| Recurso | Trabalho disponível |
|---|---|
| Projetos e versões | Crie ou selecione um projeto por CPU e tipo de programa, gerencie requisitos e especificações confirmadas, revise candidatos, compare versões e inspecione ou exporte artefatos versionados. |
| Diagnóstico nativo | Compile e verifique um GXW que corresponda à versão atual. Onde houver informações de localização, associe diagnósticos a linhas de ST, declarações, redes FBD, objetos ou instâncias de chamada; retenha um resultado não resolvido quando a localização for ambígua. |
| Projetos SFC existentes | Importe um projeto SFC existente, leia seu programa e grafo, edite subprogramas de ação e transição existentes e altere números de ação de etapas e alvos de salto suportados. Visualize candidatos e diferenças de versão; criar um projeto SFC completo do zero não é suportado. |
| Simulação de Ladder | Defina planos de teste, entradas de dispositivos e resultados esperados; execute backends de simulação suportados; salve e revise resultados; e relacione testes a requisitos. O suporte a instruções e CPU depende do backend. |
| Monitoramento de PLC somente leitura | Com aprovação do operador, leia dispositivos selecionados por meio de uma estação lógica MX Component configurada e visualize valores e registros de leitura. Permissões revogáveis são vinculadas à versão do projeto, ao intervalo de endereços e à expiração; este recurso não grava no PLC. |
Início rápido
No Windows 10/11 x64, escolha um componente na página de releases. Os dois pacotes instalam de forma independente e não exigem Python.
| Componente | Uso | Requisitos |
|---|---|---|
| GXWorks-Agent-MCP-windows-x64.zip | Conecte um cliente MCP, como o Codex, e use seu modelo | Sem Web ou Node.js necessário |
| GXWorks-Agent-Web-windows-x64.zip | Gere, edite e gerencie projetos em um ambiente de trabalho no navegador | Node.js 22.14 ou mais recente; sem MCP necessário |
MCP independente
Extraia o pacote MCP inteiro e adicione um servidor stdio no seu cliente: use o gxworks-agent-mcp.exe extraído como comando e --local como argumento. Atualize a conexão do cliente, chame list_projects e selecione um projeto ou crie um com a CPU e o tipo de programa reais.
Experimente: “Crie um projeto Ladder FX3U. Leia o contexto de geração e as evidências de instruções relevantes. Conte cada acionamento de X0, ligue Y0 após três contagens e redefina com X1. Salve o candidato e mostre seus artefatos e diagnósticos restantes.”
Clientes externos usam seus próprios modelos sem executar o Web. A importação para GX segue o consentimento de execução configurado. Para compartilhar um projeto Web e seu fluxo de revisão, veja componentes e conexões opcionais.
Ambiente de trabalho Web
Extraia o pacote Web inteiro e execute estes comandos no diretório dele:
npm install
npm run build
npm start
Você também pode clonar este repositório e executar os mesmos comandos; o primeiro início baixa o runtime correspondente. O navegador abre automaticamente. Os projetos usam %LOCALAPPDATA%/GXWorks Agent/web-workspace por padrão, sem necessidade de seleção de espaço de trabalho.
Crie um projeto e configure uma API de modelo em Configurações → Modelo → API do Modelo para gerar programas. Visualizar projetos existentes não exige chamada de modelo. Extraia atualizações em um novo diretório; projetos existentes e configurações pessoais são mantidos.
Salvamento nativo, verificação de código, importação para GX e simulação exigem o software Mitsubishi correspondente instalado localmente. O monitoramento de PLC somente leitura exige MX Component e uma estação lógica configurada. Esses aplicativos Mitsubishi não estão incluídos nos pacotes.
Escopo atual
- A integração com GX exige Windows; a entrega no desktop precisa de uma sessão interativa do Windows.
- A integração nativa com FBD está vinculada ao GX Works2 1.635.0.1. Geração, edição e exportação de Ladder e ST não exigem essa versão. A edição de FBD usa a CPU e as interfaces do projeto de origem; o modelo inicial integrado é FX3U, e outras CPUs precisam de um projeto importado correspondente.
- A disponibilidade do menu de CPU não implica cobertura uniforme de instruções ou validação. Perfis de validação não suportados retornam um resultado não verificado.
- O FBD suporta objetos, conexões, declarações, redes e criação de FB/Programa vinculados à fonte. O SFC tem edição via backend/MCP para subprogramas de ação e transição existentes; não é um IDE gráfico completo de SFC.
- Um artefato salvo ou uma importação bem-sucedida não estabelece compilação bem-sucedida ou comportamento correto do PLC.
Antes de operar máquinas
Revise a lógica gerada em relação à CPU selecionada, à fiação, aos limites de movimento e aos modos de operação. Faça backup do projeto GX de destino antes da importação e, em seguida, compile e inspecione-o no ambiente GX Works2 pretendido antes da comissionamento. Enviar para o GX Works2 não baixa um programa para um PLC.
Paradas de emergência, proteções e outras funções de segurança exigem um sistema de segurança independente. A lógica de aplicação gerada e as verificações de software não o substituem. Sanitize diagnósticos antes de compartilhar; nunca publique credenciais ou links de sessão local.
Guias e licença
Componentes e conexões opcionais · Contribuindo · Issues · Segurança
A interface Web pública e seus arquivos públicos acompanhantes usam MPL-2.0; veja o escopo da licença. O núcleo fechado e os adaptadores nativos usam o Acordo de Uso Gratuito de Runtime separado, incluindo uso comercial interno gratuito. Contribuidores mantêm seus direitos autorais. Distribuições sob esses termos devem reter as licenças aplicáveis, avisos de terceiros e disponibilidade de fonte MPL. Versões anteriores mantêm suas licenças originais.