SimScale Edge MCP

An MCP server that navigates the SimScale Workbench through Microsoft Edge and Playwright. It does not use the enterprise SimScale API.

The server opens a visible, MCP-managed Edge window with a persistent profile. Sign in to SimScale manually the first time. The login remains in that dedicated profile for later sessions.

Requirements

• Node.js 20 or newer
• Microsoft Edge
• A SimScale account

Install

npm install

Playwright Core drives the copy of Microsoft Edge already installed on Windows; it does not download a separate browser.

Connect an MCP host

Use the absolute project path:

{
  "mcpServers": {
    "simscale": {
      "command": "node",
      "args": [
        "C:\\absolute\\path\\to\\SimscaleMCP\\src\\index.js"
      ],
      "env": {
        "SIMSCALE_FILE_ROOT": "C:\\path\\containing\\your\\CAD"
      }
    }
  }
}

SIMSCALE_FILE_ROOT restricts which local files the MCP may upload and is also where result downloads are saved.

Optional environment variables:

Variable	Default	Purpose
SIMSCALE_FILE_ROOT	MCP working directory	Allowed upload/download root
SIMSCALE_EDGE_PROFILE_DIR	%LOCALAPPDATA%\SimScaleMCP\edge-profile	Persistent Edge profile
SIMSCALE_EDGE_CHANNEL	msedge	Playwright browser channel
SIMSCALE_DASHBOARD_URL	SimScale My Projects	Initial page
SIMSCALE_ALLOW_CSS_SELECTORS	unset	Set to enable advanced CSS targets

First use

1. Call simscale_edge_start.
2. If SimScale shows its login page, sign in directly in Edge.
3. Call simscale_edge_status and verify signedIn is true.
4. Call simscale_page_state before each interaction.
5. Use the returned labels, roles, or test IDs with simscale_click, simscale_fill, simscale_select, and simscale_press.

For CAD uploads, point SIMSCALE_FILE_ROOT at the CAD folder and use simscale_upload_file with confirm_upload: true. Starting a mesh or simulation run, saving, creating, deleting, or other state-changing clicks require confirm_action: true.

Available tools

• simscale_edge_start, simscale_edge_status, simscale_edge_close
• simscale_page_state, simscale_screenshot, simscale_navigate
• simscale_click, simscale_fill, simscale_press, simscale_select
• simscale_upload_file, simscale_download
• simscale_wait_for_text

The tools are deliberately semantic instead of hard-coding SimScale's current DOM structure. The agent reads the live interface and targets visible, accessible labels, which makes the MCP more resilient to Workbench updates.

Test

npm test

Tests do not launch Edge or access SimScale.

Safety

• Password fields cannot be filled or read through MCP.
• Cookies, browser storage, and saved credentials are never exposed.
• Navigation is restricted to HTTPS SimScale domains.
• Uploads are restricted to SIMSCALE_FILE_ROOT and require confirmation.
• Downloads require confirmation and go to simscale-downloads.
• Mutating, destructive, and compute-related clicks require confirmation.