starccm-mcp
Reads STAR-CCM+ .sim files and solver logs without a licence, searches the local user guide and Java API reference, and runs checked macros on an open session.
What it's for
starccm-mcp drives a running copy of Simcenter STAR-CCM+ on Windows. Its documentation describes 5 capabilities and 5 limitations, summarised below.
What it can do
- Summarises a .sim file (version, mesh size, regions, physics models, parameters, reports, monitors, stopping criteria) and lists boundaries, parameters and monitor histories, without STAR-CCM+ installed.
- Summarises solver logs as an iteration table with grouped solver events, or returns a filtered tail.
- Searches the local STAR-CCM+ user guide and looks up classes and method signatures in the local Java API reference.
- Lists running STAR-CCM+ servers and takes a read-only snapshot of an open simulation.
- Runs Java macros on a running session after a check that refuses risky actions (writing files, saving, deleting, meshing, running the solver) unless you allow them.
Limitations
- The author calls the macro checker "not a sandbox". It inspects names, not types, and a macro runs with your full user rights.
- Session and macro tools work on Windows only; the .sim and log tools are plain Python.
- Licence masking in output is pattern-based, which the author calls a safeguard rather than a guarantee.
- Solution fields such as boundary density are not exposed yet.
- The README does not say whether the session tools take a licence seat, though a macro can check one out.
AI-generated models, drawings and results must be checked by a qualified engineer before use.
Install
git clone https://github.com/RHerAle/starccm-mcp
cd starccm-mcp
python -m venv .venv
.venv\Scripts\pip install -e .claude mcp add starccm -- C:\path\to\starccm-mcp\.venv\Scripts\starccm-mcp.exeSource: github.com/RHerAle/starccm-mcp#install
MCP servers and skills run code on your computer. Review the source before installing.
Want your AI assistant to walk you through it? Copy a prompt for Claude or another assistant that asks it to check your setup and get your approval before each step.
Details
- Type
- MCP server
- Works with
- Simcenter STAR-CCM+
- How it connects
- Drives a running copy of the tool
- Access
- Can modify models Questions to ask first
- Tool versions
- Tested only with STAR-CCM+ 2502 (20.02.008); other versions untested
- Operating systems
- Windows
- Licence needed
- Not stated in its documentation
- Transport
- Local (stdio)
- AI clients documented
- Claude Code, Claude Desktop What this means
- Licence
- GPL-3.0-only
- Language
- Python
Compared with other Simcenter STAR-CCM+ integrations
| Name | Type | Origin | How it connects | Licence | Stars | Updated |
|---|---|---|---|---|---|---|
| starccm-javadoc-mcp | MCP server | Community | Documentation only; doesn't operate the tool | BSD-3-Clause | 6 | 2 days ago |
| STAR-CCM+ AI Engineering Workbench | Skill | Community | Agent skill | Not stated | 14 | 2 months ago |
| starccm-mcp | MCP server | Community | Drives a running copy of the tool | GPL-3.0-only | — | — |
Facts from each project's documentation; stars and update dates from GitHub. Nothing here is ranked.
Sources
Checked 19 Nov 2026
Something wrong? Suggest an edit