GX Works Agent
Servidor MCP stdio de Windows para ingeniería de PLC Mitsubishi GX Works2. Proporciona contexto manual específico de CPU, inspección y diagnóstico de proyectos, edición de Ladder/FBD y artefactos de proyecto versionados, utilizando el modelo de IA proporcionado por el cliente MCP.
Documentación
GXWorks Agent
Herramientas MCP y un banco de trabajo de IA para ingeniería de PLC Mitsubishi.
Lee el contexto del proyecto. Construye y revisa programas. Entrega a GX Works2.
Descargas · MCP y Web · Problemas
Inicio rápido · Ladder · ST · FBD · Web · Diagnósticos
GXWorks Agent admite flujos de trabajo Ladder, Texto Estructurado (ST) y FBD nativo. Proporciona a agentes externos contexto del proyecto, instrucciones específicas de CPU, evidencia de manuales y herramientas de ingeniería a través de MCP. Conéctate mediante MCP, usa tu propio modelo y guarda artefactos de ingeniería versionados. El runtime MCP predeterminado funciona de forma independiente; el banco de trabajo Web es opcional.
Ladder: del contexto de ingeniería a un programa guardado
Un ejemplo de transportador FX3U: recupera contexto para WSFL, INC y T200, construye un candidato Ladder y guárdalo mediante MCP. Los hechos de instrucción estructurados y la evidencia de manuales informan el candidato; la versión guardada incluye JSON de Ladder, IR, SVG, ST derivado de IR y CSV de importación GX.
El GIF visualiza resultados reales de SDK/MCP y artefactos generados. El asistente construyó el candidato a partir del contexto devuelto; esto no es una grabación de un modelo integrado ejecutándose de forma autónoma.
ST: genera y revisa Texto Estructurado
ST tiene su propio flujo de trabajo de generación en el banco de trabajo Web: analiza el requisito, confirma la especificación y genera program.st usando el contexto de instrucciones y las firmas ST de la CPU seleccionada. Previsualiza el candidato, inspecciona las diferencias de texto entre versiones y guarda el artefacto ST. Los programas Ladder también pueden exportar ST trazable desde su IR de PLC.
La inspección local de ST verifica la sintaxis y semántica admitidas e informa construcciones no admitidas. Es un analizador acotado, no el compilador de GX Works2; la compilación nativa y el comportamiento del PLC permanecen separados. MCP puede proporcionar contexto ST y diagnósticos existentes, mientras que create_program_candidate actualmente acepta candidatos Ladder.
Qué proporciona la API
- Contexto vinculado al proyecto. Crea o selecciona un proyecto, lee su CPU y programa actual, descubre instrucciones aplicables e interfaces invocables, y continúa desde una versión guardada.
- RAG de ingeniería. Los hechos de instrucción con ámbito de CPU y los extractos de manuales llevan referencias de fuente. La arquitectura de recuperación combina entidad, texto completo y recuperación densa/LSA con fusión de rangos; los hechos estructurados cubren detalles de instrucción conocidos, mientras que la recuperación residual proporciona evidencia de apoyo.
- Edición de candidatos y artefactos. Envía cambios Ladder o FBD a través de herramientas de ingeniería compartidas. El núcleo verifica la estructura y los operandos admitidos, prepara artefactos y devuelve resultados vinculados a la versión. El guardado local, la compilación nativa y la verificación de comportamiento tienen resultados separados.
- Entrega a GX Works2. Con el consentimiento de ejecución configurado por el operador, importa el MAIN y los comentarios de dispositivos de la versión Ladder actual y recibe el resultado de la operación nativa. El puente Web opcional conserva la revisión del banco de trabajo.
Tu cliente o entorno proporciona el modelo y el bucle de planificación. GXWorks Agent proporciona el contexto de ingeniería, las herramientas, la persistencia y los recibos de operación.
GUI Web: inspecciona y exporta un programa
Configura una API de modelo directamente en el banco de trabajo y usa el flujo de trabajo integrado de Generación Directa, luego inspecciona las redes del programa, las direcciones de dispositivos y las exportaciones disponibles. Direct puede reducir la sobrecarga de orquestación de agentes externos; el uso real de tokens depende del modelo y la tarea. Comparte el pipeline de contexto de ingeniería con MCP, y las preguntas y respuestas del banco de trabajo aún pueden involucrar bucles de herramientas.
FBD: edita un proyecto GXW existente
Agrega enclavamiento de fallas, reinicio y un retardo de habilitación de 500 ms al primer eje del ejemplo MotionControl JEC de Mitsubishi Electric. La edición preserva las implementaciones de FB existentes y el cableado del Eje IN_OUT, agrega lógica SR/TON y conecta el permiso al bloque de control de potencia existente.
Fuente: Ejemplo MotionControl JEC de Mitsubishi Electric.
FBD va más allá del cambio de cableado en la demostración. Genera o edita candidatos desde un proyecto inicial o un GXW importado; agrega, cambia o elimina objetos, conexiones, declaraciones y múltiples redes; usa interfaces de FB de proyecto/biblioteca y parámetros IN_OUT; e inspecciona vistas previas gráficas, diferencias de versiones y artefactos GXW.
Donde el proyecto fuente lo admita, crea FBs y Programas. Un nuevo Programa puede registrarse en una tarea existente, una nueva tarea o un nuevo recurso. El guardado nativo, la compilación y la verificación de código son operaciones separadas con resultados vinculados a la versión correspondiente del proyecto.
Gestión de proyectos, diagnósticos y validación
| Característica | Trabajo disponible |
|---|---|
| Proyectos y versiones | Crea o selecciona un proyecto por CPU y tipo de programa, gestiona requisitos y especificaciones confirmadas, revisa candidatos, compara versiones e inspecciona o exporta artefactos versionados. |
| Diagnósticos nativos | Compila y verifica un GXW que coincida con la versión actual. Cuando la información de ubicación esté disponible, asocia diagnósticos con líneas ST, declaraciones, redes FBD, objetos o instancias de llamada; conserva un resultado no resuelto cuando la ubicación sea ambigua. |
| Proyectos SFC existentes | Importa un proyecto SFC existente, lee su programa y gráfico, edita subprogramas de acción y transición existentes, y cambia números de acción de paso y destinos de salto admitidos. Previsualiza candidatos y diferencias de versiones; no se admite crear un proyecto SFC completo desde cero. |
| Simulación Ladder | Define planes de prueba, entradas de dispositivos y resultados esperados; ejecuta backends de simulación admitidos; guarda y revisa resultados; y relaciona pruebas con requisitos. El soporte de instrucciones y CPU depende del backend. |
| Monitoreo de PLC de solo lectura | Con aprobación del operador, lee dispositivos seleccionados a través de una estación lógica MX Component configurada y visualiza valores y registros de lectura. Los permisos revocables están vinculados a la versión del proyecto, el rango de direcciones y la expiración; esta característica no escribe en el PLC. |
Inicio rápido
En Windows 10/11 x64, elige un componente desde la página de versiones. Los dos paquetes se instalan de forma independiente y no requieren Python.
| Componente | Uso | Requisitos |
|---|---|---|
| GXWorks-Agent-MCP-windows-x64.zip | Conecta un cliente MCP como Codex y usa su modelo | No requiere Web ni Node.js |
| GXWorks-Agent-Web-windows-x64.zip | Genera, edita y gestiona proyectos en un banco de trabajo de navegador | Node.js 22.14 o más reciente; no requiere MCP |
MCP independiente
Extrae todo el paquete MCP y agrega un servidor stdio en tu cliente: usa el gxworks-agent-mcp.exe extraído como comando y --local como su argumento. Actualiza la conexión del cliente, llama a list_projects, luego selecciona un proyecto o crea uno con su CPU y tipo de programa reales.
Prueba: “Crea un proyecto Ladder FX3U. Lee el contexto de generación y la evidencia de instrucciones relevante. Cuenta cada pulsación de X0, activa Y0 después de tres conteos y reinicia con X1. Guarda el candidato y muestra sus artefactos y diagnósticos restantes.”
Los clientes externos usan sus propios modelos sin ejecutar Web. La importación GX sigue el consentimiento de ejecución configurado. Para compartir un proyecto Web y su flujo de revisión, consulta componentes y conexiones opcionales.
Banco de trabajo Web
Extrae todo el paquete Web y ejecuta estos comandos en su directorio:
npm install
npm run build
npm start
También puedes clonar este repositorio y ejecutar los mismos comandos; el primer inicio descarga el runtime correspondiente. El navegador se abre automáticamente. Los proyectos se guardan por defecto en %LOCALAPPDATA%/GXWorks Agent/web-workspace, sin necesidad de seleccionar un espacio de trabajo.
Crea un proyecto y configura una API de modelo en Configuración → Modelo → API de modelo para generar programas. Ver proyectos existentes no requiere llamadas al modelo. Extrae las actualizaciones en un nuevo directorio; los proyectos existentes y la configuración personal se conservan.
El guardado nativo, la verificación de código, la importación GX y la simulación requieren el software Mitsubishi correspondiente localmente. El monitoreo de PLC de solo lectura requiere MX Component y una estación lógica configurada. Estas aplicaciones Mitsubishi no están incluidas en los paquetes.
Alcance actual
- La integración GX requiere Windows; la entrega de escritorio necesita una sesión interactiva de Windows.
- La integración FBD nativa está vinculada a GX Works2 1.635.0.1. La generación, edición y exportación de Ladder y ST no requieren esta versión. La edición FBD usa la CPU e interfaces del proyecto fuente; la plantilla inicial integrada es FX3U, y otras CPUs necesitan un proyecto importado que coincida.
- La disponibilidad del menú de CPU no implica cobertura uniforme de instrucciones o validación. Los perfiles de validación no admitidos devuelven un resultado no verificado.
- FBD admite objetos, conexiones, declaraciones, redes y creación de FB/Programas vinculados a la fuente. SFC tiene edición backend/MCP para subprogramas de acción y transición existentes; no es un IDE SFC gráfico completo.
- Un artefacto guardado o una importación exitosa no establece una compilación exitosa ni un comportamiento correcto del PLC.
Antes de operar maquinaria
Revisa la lógica generada contra la CPU seleccionada, el cableado, los límites de movimiento y los modos de operación. Haz una copia de seguridad del proyecto GX de destino antes de la importación, luego compila e inspecciónalo en el entorno GX Works2 previsto antes de la puesta en marcha. Enviar a GX Works2 no descarga un programa a un PLC.
Las paradas de emergencia, los resguardos y otras funciones de seguridad requieren un sistema de seguridad independiente. La lógica de aplicación generada y las verificaciones de software no lo reemplazan. Sanea los diagnósticos antes de compartirlos; nunca publiques credenciales o enlaces de sesión locales.
Guías y licencia
Componentes y conexiones opcionales · Contribuir · Problemas · Seguridad
La interfaz Web pública y sus archivos públicos adjuntos usan MPL-2.0; consulta el alcance de la licencia. El núcleo cerrado y los adaptadores nativos usan el Acuerdo de Uso Gratuito de Runtime separado, incluido el uso comercial interno gratuito. Los contribuyentes conservan sus derechos de autor. Las distribuciones bajo estos términos deben conservar las licencias aplicables, los avisos de terceros y la disponibilidad de fuente MPL. Las versiones anteriores conservan sus licencias originales.