Sigmatek LASAL MCP Server

A Model Context Protocol (MCP) server for automating the Sigmatek LASAL software suite. It enables AI coding assistants (like Claude, Gemini, or Cursor) to inspect projects, apply structural CLASS 2 or VISUDesigner HMI changes, compile, download to hardware, read/write live PLC values, and control PLC execution.

Warning: This is NOT an official Sigmatek product. This project is in active development — bugs and unpredictable behavior are likely. Do not use on production projects without backups or version control.

Features

• Project Navigation: Select the active project directory and auto-resolve .lcp and .lvp paths.

• CLASS 2 Automation:

  • Inspect project structure (classes, networks, connections, server/client channels).

  • Open and close the CLASS 2 IDE.

  • Apply structural edits (create/delete/rename networks, add/remove/rename objects, connect/disconnect channels, set init values).

  • Read and write class .st source files directly.

  • Compile projects and read compiler logs (errors and warnings).

• VISUDesigner Automation:

  • Inspect HMI projects (stations, datapoints, text lists, schemes).

  • Open and close VISUDesigner.

  • Apply changes headlessly (sync datapoints, edit properties, configure schemes, manage media assets, add code modules).

  • CSV translation import and export.

  • Direct dashboard/window/style editing via JSON.

• PLC Runtime & Live Connection:

  • Configure target online IP addresses.

  • Download projects to the target PLC or HMI.

  • Read and write live channel values from a running PLC.

  • Start, stop, or query the current PLC runtime state.

  • PLC diagnostics (tracing, file transfer, static code analysis).

• HMI Simulation:

  • Local HMI web runtime via LasalVISUDataService.

  • Headless Edge browser automation for testing.

Related MCP server: B&R Automation Studio MCP Server

Prerequisites

• Windows OS (Sigmatek LASAL suite runs exclusively on Windows).

• Node.js v18 or higher.

• Sigmatek LASAL Suite:

  • LASAL CLASS 2 (PLC engineering).

  • VISUDesigner (HMI design).

Installation & Setup

git clone <repository-url>
cd Lasal-MCP
npm install
npm run build

Configuration

Environment Variables

Connecting to MCP Clients

Claude Desktop

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "lasal-mcp": {
      "command": "node",
      "args": ["C:/path/to/Lasal-MCP/dist/server.js"],
      "env": {
        "LASAL_CLASS2_EXE": "C:\\Program Files (x86)\\Sigmatek\\Lasal\\Class2\\Bin\\Lasal2.exe",
        "LASAL_VISUDESIGNER_EXE": "C:\\Program Files\\Sigmatek\\Lasal\\VISUDesigner\\VISUDesigner.exe"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json or run claude mcp add:

{
  "mcpServers": {
    "lasal-mcp": {
      "command": "node",
      "args": ["C:/path/to/Lasal-MCP/dist/server.js"]
    }
  }
}

Available Tools

Development

npm run dev          # Watch mode
npm test             # Run tests (Vitest)
npm run test:watch   # Tests in watch mode
npm run lint         # ESLint
npm run format       # Prettier
npm run inspector    # MCP Inspector for interactive debugging

Architecture

See ARCHITECTURE.md for the full codebase layout, key patterns (engine mutex, script execution, file encoding, transactional edits), and environment variable reference.