Maxsurf MCP

MCP serverCommunity

A Windows MCP server that drives running Maxsurf Modeler, Stability, Resistance, Motions and Multiframe over COM. By Ismail Hakki Celik.

6 starsUpdated 8 weeks agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: Maxsurf
How it connects: Drives a running copy of the tool
Access: Can modify models
Tool versions: Tested against Maxsurf 2025 build 25.00.02.339; other builds unchecked (release candidate 0.2.0-rc.5)
Operating systems: Windows
Needs a Maxsurf licence: Yes
Transport: Local (stdio)
AI clients documented: Claude Desktop, Codex
Licence: MIT
Language: Python

What it can do

Reads and edits Modeler surfaces, control nets and the design grid, and returns upright hydrostatics.
Sets up Stability tanks, load cases and damage cases and runs equilibrium, heel and GZ analyses against a criteria library you choose.
Transfers a hull to Resistance and Motions, runs the native calculations and exports result tables.
Builds and analyses Multiframe beam models, including linear static and modal runs, and pages results back as JSON.

Limitations

A technical preview (0.2.0-rc.5) that its author says has incomplete native-analysis, persistence and clean-install acceptance.
The README states it is not a class-compliance authority; tool success doesn't validate a design.
Needs Windows x64, 64-bit CPython 3.12 and Bentley applications with COM automation entitlement; the default policy expects the application to be open already.
A known discrepancy between Modeler and Stability KG values was unresolved at release.

Install

In Claude Desktop open Settings > Extensions > Advanced settings > Install extension, select the downloaded .mcpb file, then in Configure Maxsurf MCP choose your 64-bit Python 3.12 executable and a design workspace folder.

Source: github.com/ishakkicelik/maxsurf-mcp/blob/main/docs/INSTALL.md#claude-desktop-extension

codex plugin marketplace add "C:/MaxsurfBridge"
codex plugin add maxsurf-mcp@maxsurf-local

Source: github.com/ishakkicelik/maxsurf-mcp#connect-to-codex

Set-Location 'C:\MaxsurfSource'
$maxsurfPython = (py -3.12 -c "import sys; print(sys.executable)").Trim()
.\scripts\install.ps1 -Python $maxsurfPython

Source: github.com/ishakkicelik/maxsurf-mcp#install-through-powershell

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.