Skip to main content
Glama
SimScale Edge MCP

SimScale Edge MCP

by getanirao

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 recommended mode attaches to your normal, already signed-in Edge profile. Remote debugging must be enabled from Edge's built-in edge://inspect page. The fallback mode opens a separate MCP-managed profile.

Requirements

  • Node.js 20 or newer

  • Microsoft Edge

  • A SimScale account

Related MCP server: Playwright Server MCP

Install

npm install

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

Start the host broker

Codex's command sandbox can prevent a stdio MCP child from completing Edge's DevTools WebSocket upgrade. Start the loopback-only host broker from a normal PowerShell window before opening Codex:

powershell -ExecutionPolicy Bypass -File .\scripts\start-simscale-host.ps1

The broker listens only on 127.0.0.1:43127. Stop it when finished with:

powershell -ExecutionPolicy Bypass -File .\scripts\stop-simscale-host.ps1

Connect an MCP host

Use the broker's Streamable HTTP endpoint:

{
  "mcpServers": {
    "simscale": {
      "url": "http://127.0.0.1:43127/mcp"
    }
  }
}

The launcher sets SIMSCALE_FILE_ROOT to this project directory. It restricts which local files the MCP may upload and is also where result downloads are saved. Change that assignment in scripts/start-simscale-host.ps1 if your CAD files live elsewhere.

Optional environment variables:

Variable

Default

Purpose

SIMSCALE_FILE_ROOT

MCP working directory

Allowed upload/download root

SIMSCALE_EDGE_USER_DATA_DIR

unset

Discover a debugging-enabled Edge instance

SIMSCALE_EDGE_CDP_URL

unset

Advanced fixed-port attachment override

SIMSCALE_EDGE_CONNECT_TIMEOUT_MS

30000

Edge attachment timeout, from 5 to 120 seconds

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

Use your already signed-in Edge profile

Run the helper to open Edge's supported remote-debugging settings:

powershell -ExecutionPolicy Bypass -File .\scripts\start-edge-debug.ps1

On the Remote debugging page, enable Allow remote debugging for this browser instance. Set SIMSCALE_EDGE_USER_DATA_DIR to Edge's user-data directory (normally %LOCALAPPDATA%\Microsoft\Edge\User Data). The MCP reads only Edge's DevToolsActivePort handshake file, attaches to that Edge instance, and opens or reuses a SimScale tab. It does not read cookies or profile files and will not close your personal Edge browser.

If an MCP process is forcibly stopped while attached, toggle remote debugging off and on before reconnecting. Restart the MCP host after changing its server registration or updating this server's code so it launches a fresh process.

Remote debugging gives local software control over browser tabs. Edge binds its debugging endpoint locally, and this MCP restricts its navigation to HTTPS SimScale domains. Turn remote debugging off when finished.

First MCP use

  1. Call simscale_edge_start.

  2. Call simscale_edge_status and verify connectionMode is attached and signedIn is true.

  3. Call simscale_select_page with the expected SimScale project_id. The MCP pins that project and prefers its Workbench tab over Dashboard tabs.

  4. Call simscale_wait_for_workbench_ready, then simscale_page_state before each interaction. Use container, text_filter, offset, and max_items to retrieve the relevant slice of a large Workbench tree.

  5. Prefer the returned element_id, followed by test_id, role/name, or label with simscale_click, simscale_fill, simscale_select, and simscale_press.

  6. Pass the pinned project as expected_project_id on every navigation or UI-changing tool. The MCP rejects missing or mismatched project IDs before interacting.

Action tools optionally accept expect_text, expect_url, expect_value, and expect_timeout_ms. Their results include the current project, simulation, and run identity so callers can verify that the intended Workbench state remained active.

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_edge_diagnostics

  • simscale_select_page, simscale_wait_for_workbench_ready

  • 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.

  • CDP attachment is restricted to explicit HTTP or WebSocket loopback ports.

  • Navigation is restricted to HTTPS SimScale domains.

  • Project pages can be pinned, and UI-changing tools require a matching expected_project_id.

  • 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.

  • Attached mode never closes the user's personal Edge browser.

Available Tools

13 tools
simscale_clickA

Click one unique visible SimScale control using its role, label, text, or test ID. Mutating or compute-related labels require confirm_action=true.

Inputs: target (required), confirm_action.

simscale_downloadA

Click a unique SimScale download control and save the result under SIMSCALE_FILE_ROOT/simscale-downloads. Requires confirm_download=true.

Inputs: target (required), confirm_download (required).

simscale_edge_closeA
Idempotent

Close the MCP-managed Edge window. The persistent login profile remains for the next session.

Inputs: no named parameters.

simscale_edge_startA

Open SimScale in a persistent Microsoft Edge profile. Log in manually if needed.

Inputs: no named parameters.

simscale_edge_statusA
Read-onlyIdempotent

Check whether Edge is running and whether the current SimScale page appears signed in.

Inputs: no named parameters.

simscale_fillA

Fill one unique visible SimScale field. Password fields are blocked and must be completed manually in Edge.

Inputs: value (required), target (required).

simscale_navigateA

Navigate Edge to an HTTPS SimScale URL. Other domains are blocked.

Inputs: url (required).

simscale_page_stateA
Read-onlyIdempotent

Read the current SimScale page's headings, notices, and visible interactive controls without exposing passwords or cookies.

Inputs: max_items.

simscale_pressA

Press a keyboard key on one unique visible SimScale control, such as Enter or Escape.

Inputs: key (required), target (required).

simscale_screenshotA
Read-only

Capture the current visible SimScale viewport as a PNG image.

Inputs: no named parameters.

simscale_selectC

Choose an option in a native SimScale select control.

Inputs: option (required), target (required).

simscale_upload_fileA

Upload a CAD or other local file from SIMSCALE_FILE_ROOT through a visible file input. Requires confirm_upload=true.

Inputs: target (required), file_path (required), confirm_upload (required).

simscale_wait_for_textA
Read-only

Wait for visible SimScale text, useful for CAD imports, meshing, and run status transitions.

Inputs: text (required), timeout_ms.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 13 tools

    Disambiguation5/5

    Each tool targets a distinct browser automation concern: lifecycle (start/status/close), page reading (page_state, screenshot), navigation, and user interactions (press, click, fill, select, upload, download). The descriptions clearly separate state inspection from content inspection and from mutating actions.

    Naming Consistency4/5

    All tools share the simscale_ prefix and mostly use verb-first naming (start, navigate, click, fill, select, upload, download). Minor deviation: three tools include 'edge' in the middle (simscale_edge_start/status/close) while the rest do not, and page_state is noun-based, but the pattern remains predictable.

    Tool Count5/5

    Thirteen tools is a well-scoped set for a browser automation server. Each tool covers a necessary step in interacting with a web application, without redundancy or bloat.

    Completeness4/5

    The tool surface covers the full cycle: start, authenticate/check, navigate, inspect, interact, upload, wait, download, and close. Minor gaps like scrolling or hovering are absent but not critical for typical SimScale workflows, and the wait_for_text covers status transitions.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      Not graded
      maintenance
      A MCP server that provides browser automation tools, allowing users to navigate websites, take screenshots, click elements, fill forms, and execute JavaScript through Playwright.
      8
      2
      Apache 2.0
    • A
      license
      B
      quality
      D
      maintenance
      A browser automation server providing Playwright capabilities for controlling web browsers, capturing screenshots, extracting content, and performing complex interactions through an MCP interface.
      6
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that enables AI-powered browser automation, web scraping, and testing using Playwright across Chromium, Firefox, and WebKit. It allows users to perform actions like navigation, clicking, typing, and taking screenshots through natural language interfaces.
      MIT