SimScale MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
SimScale MCP Server
An unoffical Python MCP (mcp v2.x MCPServer over stdio) wrapper for the SimScale REST API v0 (https://api.simscale.com/v0), using SI units. This code was developed using the offical SimScale SDK documentation as a reference point.
Requirements
Python: Python 3.11+ (tested on Python 3.14/Windows 11)
Dependencies:
mcp>=2.0.0,<3.0.0,requests>=2.31.0SimScale API Key: Generated from your SimScale account settings
Related MCP server: Dependency-Track MCP Server
Installation (Windows 11)
Clone the repository (or download and extract the ZIP) in PowerShell:
git clone https://github.com/HighMars1/simscale-mcp-server.git cd simscale-mcp-serverCreate a virtual environment and install dependencies: (Using
.venv\Scripts\python.exe -m pipdirectly avoids PowerShell script execution-policy errors.)python -m venv .venv .venv\Scripts\python.exe -m pip install -r requirements.txtVerify the script compiles:
.venv\Scripts\python.exe -m py_compile simscale_mcp_server.py
Configuration
Your MCP client launches this server automatically and passes configuration through environment variables:
SIMSCALE_API_KEY(required): Your SimScale REST API key.SIMSCALE_DOWNLOAD_DIR(strongly recommended): Folder wheredownload_simulation_resultis allowed to save files (e.g.C:/Users/<YourName>/Downloads/simscale). If omitted, it defaults to the process working directory, which may be a read-only system/app folder when launched by an MCP client.SIMSCALE_API_URL(optional): Base SimScale API URL (defaults tohttps://api.simscale.com).
MCP Client Setup (stdio)
Add the following entry to your MCP client's configuration file (for example in Google Antigravity, Claude Desktop, or Cursor).
{
"mcpServers": {
"simscale": {
"command": "C:/path/to/simscale-mcp-server/.venv/Scripts/python.exe",
"args": [
"C:/path/to/simscale-mcp-server/simscale_mcp_server.py"
],
"env": {
"SIMSCALE_API_KEY": "your-simscale-api-key",
"SIMSCALE_DOWNLOAD_DIR": "C:/Users/<YourName>/Downloads/simscale"
}
}
}
}Note: Because this is a
stdioMCP server, runningsimscale_mcp_server.pydirectly in PowerShell will appear to hang while it waits for JSON-RPC messages on standard input. Always let your MCP client start it using the config above (pressCtrl+Cif you ran it manually).
Available MCP Tools (42 Tools)
Projects
Tool | Mode | Description |
| Read | List projects in the workspace ( |
| Read | Get project metadata and |
| Write | Create a new SimScale project (strictly enforces |
Geometries, Imports & Primitives
Tool | Mode | Description |
| Read | List imported CAD geometries in a project. |
| Read | Get metadata for a single CAD geometry. |
| Write | Upload a local CAD file ( |
| Read | Check import status ( |
| Read | Retrieve CAD import warnings or failure diagnostics. |
| Read | Retrieve internal topological entity names ( |
| Write | Create a geometry primitive (box, cylinder, sphere, point, etc.) with SI unit validation. |
Materials & Tabular Data
Tool | Mode | Description |
| Read | List available SimScale material groups. |
| Read | List materials inside a material group. |
| Read | Get physical properties for a specific material. |
| Write | Upload a local CSV/tabular boundary-condition file to |
Simulations & Validation
Tool | Mode | Description |
| Read | List all simulations in a project. |
| Read | Get the full JSON specification of a simulation. |
| Write | Create a simulation in an |
| Write | Replace an existing simulation's JSON specification (validates coherent SI units; handles |
| Read | Run pre-flight validation checks on a simulation setup. |
| Read | Estimate compute resource consumption (core hours and duration). |
Meshing
Tool | Mode | Description |
| Read | List all mesh operations in a project. |
| Read | Get mesh operation spec, status, and resulting |
| Read | Retrieve meshing progress and failure diagnostics. |
| Write | Create a mesh operation from a JSON spec (validates coherent SI units). |
| Write | Update an existing mesh operation spec (validates coherent SI units). |
| Read | Validate a mesh operation setup (pass |
| Read | Estimate compute resources for a mesh operation. |
| Compute | Start generating a mesh (consumes core hours). |
| Compute | Cancel an active or queued mesh operation. |
| Read | List generated meshes in a project. |
| Read | Get metadata for a generated mesh by |
Simulation Runs
Tool | Mode | Description |
| Read | List runs for a simulation. |
| Read | Get status ( |
| Read | Get the exact simulation specification snapshot used by a run. |
| Read | Retrieve solver event logs for a run. |
| Compute | Create and start a new run ( |
| Compute | Start an already-created |
| Compute | Cancel an active or queued simulation run. |
Results & Exports
Tool | Mode | Description |
| Read | List available result artifacts ( |
| Write | Request an asynchronous format conversion/export for a |
| Read | Poll status and download URL of an export job. |
| Write | Stream-download a result artifact into |
Notes & Disclosure
If you open an API-created or API-updated simulation in the SimScale web Workbench and see:
"Your Simulation model version is not fully compatible with the Workbench. Edit mode is disabled to prevent unexpected breaking changes."
This is expected SimScale behavior when the version field in the SimulationSpec JSON differs from the latest Workbench UI schema version.
Portions of the code, bug fixes, and documentation in this repository were generated and reviewed with the assistance of AI tools.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read and write shared BitsWeave context, projects, tasks, and work sessions through MCP.
QuLab MCP remote server (Streamable HTTP) for computational science and lab tools.
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables MCP clients to connect to Agenzax's REST API over stdio, providing tools for messaging, session management, and review-mode oversight.18135 npm5MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to query projects, fetch findings, trigger analysis, upload CycloneDX BOMs, and check async token status against an OWASP Dependency-Track instance via stdio.MIT
- AlicenseBqualityBmaintenanceEnables MCP-capable clients to drive Worksection projects, tasks, subtasks, comments, tags, people, time tracking, files, search, and reporting through a consistent set of tools over stdio.53MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients to interact with the Crewmeister API over local stdio, covering operations for members, teams, time tracking, salary exports, and related platform resources.Apache 2.0