How arienax/gxworks-agent works
GXWorks Agent provides MCP engineering tools and a browser workbench for Mitsubishi PLC projects. Users supply project context and requirements, then plan or generate Ladder, ST, or FBD work, review and validate candidates, and save or deliver engineering artifacts; GXW projects can also be inspected and edited offline. Separate capabilities include CPU-scoped engineering knowledge, simulation, and native GX Works2 operations. The README documents the product workflow; some subsystem links below are dashed where sampled source does not establish runtime wiring.
Main entry points: projects.py Project workflow · generation.py Program generation · server.py MCP server · app.py Web workbench
Components 21
User interfaces
- MCP server
src/integrations/mcp/server.py - Web workbench
src/integrations/web/app.py
Engineering workflow
- Engineering sessions
src/application/engineering_session.py - Project workflow
src/application/projects.py - Specification
src/application/spec_document.py - Program generation
src/application/generation.py - Review and checks
src/inspection/engine.py - Artifact delivery
src/application/delivery.py - Project and session state
src/storage
PLC authoring
- PLC intermediate model
src/plc/ir.py - PLC validation
src/plc/validation.py - GXW authoring and codec
src/gxw - FBD workflows
src/application/fbd.py
Knowledge and simulation
- Engineering knowledge
src/knowledge - Simulation workbench
src/simulator/service.py
Native engineering
- Native operations
src/application/native_engineering.py - Live engineering
src/application/live_engineering.py - GX Works2 driver
src/gxworks2/engineering_driver.py - Offline GXW editing
src/application/gxw_files.py
Other components
- MCP client
- Workbench user
Connections 22
- MCP client → MCP server: requests tools
README.md - MCP server → Engineering sessions: dispatches tools
src/integrations/mcp/server.py - Workbench user → Web workbench: uses workbench
README.md - Web workbench → Project workflow: accesses projects
- Engineering sessions → Project workflow: manages projects
src/application/engineering_session.py - Project workflow → Specification: supports specification
src/application/projects.py - Project workflow → Program generation: starts generation
- Program generation → Engineering knowledge: uses CPU facts
README.md - Program generation → PLC intermediate model: produces PLC model
- Program generation → Review and checks: submits candidates
- Review and checks → PLC validation: checks programs
src/inspection/engine.py - Project workflow → Artifact delivery: delivers artifacts
- Project workflow → Project and session state: stores versions
src/application/projects.py - Artifact delivery → GXW authoring and codec: exports GXW artifacts
- FBD workflows → GXW authoring and codec: uses GXW models
src/application/gxw_files.py - Workbench user → Simulation workbench: tests simulations
README.md - Project workflow → Simulation workbench: supports simulation
- MCP server → Offline GXW editing: exposes GXW tools
README.md - Web workbench → Offline GXW editing: supports GXW import
README.md - Project workflow → Native operations: requests native work
src/application/native_engineering.py - Native operations → GX Works2 driver: runs native operations
- Live engineering → GX Works2 driver: coordinates live session
src/application/live_engineering.py