Skip to main content
Glama
jiangshirong

FreeShip MCP

by jiangshirong
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

FreeShip MCP

简体中文

A Windows MCP server for FreeShip model inspection, control-net editing, hull transformation, geometry diagnostics and engineering exports. Powered by the native FreeShip Plus engine.

Features

  • Read and write FBM/FTM models, including fv335 and fv462.

  • Edit control points, edges and faces; scale geometry and apply Lackenby transformations.

  • Generate stations, waterlines and buttocks at specified positions.

  • Inspect topology, sampled curve quality and coordinate constraints.

  • Calculate hydrostatics at individual drafts or across a draft range.

  • Export three-view DXF linesplans and CSV/XLSX reports with source manifests.

Related MCP server: SolidworksMCP

Installation

Platform: Windows 10/11 x64. Transport: stdio.

Download FreeShip-MCP-Windows-x64.zip from Releases, then extract it. The standalone package includes the runtime and calculation engine.

Alternatively, install the Windows wheel with Python 3.11 or later:

py -3.11 -m venv .venv
.venv\Scripts\python -m pip install .\freeship_mcp-0.3.0-py3-none-win_amd64.whl

Configuration

Create a workspace directory and add the server to your MCP client configuration:

{
  "mcpServers": {
    "freeship": {
      "command": "C:\\MCP\\freeship-mcp\\freeship-mcp.exe",
      "args": ["--workspace", "C:\\HullWork", "--timeout", "120"]
    }
  }
}

For a wheel installation, use .venv\Scripts\freeship-mcp.exe as the command.

Option

Description

--workspace

Required existing directory containing input models and outputs

--timeout

Native operation timeout in seconds; default 120

--engine

Optional path to a compatible native engine

--check

Check engine compatibility and exit

Paths are restricted to the configured workspace. Outputs use new filenames. Logs are written to stderr.

Tools

Tool

Description

engine_info

Engine version, upstream revision and capabilities

inspect_model

Project settings, geometry bounds, layers, units and control-net indices

validate_model

Topology, adjacent face orientation and open-boundary diagnostics

edit_control_net

Move, align or relax points; split edges/faces; add or delete faces; set creases

analyze_hull_quality

Sampled curve diagnostics and explicit coordinate checks

verify_model_targets

Compare model measurements with specified targets and tolerances

check_export_source

Verify export and source-model hashes

save_model

Save or convert FBM/FTM models

scale_model

Scale geometry and project dimensions

rebuild_hull

Apply a Lackenby transformation to selected layers

generate_sections

Generate stations, waterlines and buttocks

calculate_hydrostatics

Calculate at a specified draft, trim and heel

calculate_hydrostatics_series

Calculate for a draft list or range

export_linesplan_dxf

Export profile, plan and body views with outlines, grids and labels

export_hydrostatics

Export CSV or XLSX data and charts

API physical units are metres, metric tonnes and degrees; areas and volumes use m² and m³. Legacy FBM text encoding supports cp1252, cp1251 and utf8.

Local edits require the model SHA-256 returned by inspection. Target values and tolerances are explicit inputs. Version 0.3.0 uses native protocol 3; update the server and engine together.

Documentation

Development

py -3.11 -m venv .venv
.venv\Scripts\python -m pip install -r requirements-dev.lock
.venv\Scripts\python -m pip install --no-deps --no-build-isolation -e .
scripts\bootstrap-toolchain.ps1
scripts\build-engine.ps1
.venv\Scripts\python -m pytest -q
scripts\package-windows.ps1

The build uses Free Pascal 3.2.2 and Lazarus 3.2. Pinned upstream sources and build instructions are included in the repository; see UPSTREAM.json and upstream changes.

License

GPL-3.0-or-later. Original FreeShip and dependency notices are retained in NOTICE. This project is an independent FreeShip adapter.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • AutoCAD MCP Server - Codex

    beiming183-cloud
    A
    license
    A
    quality
    C
    maintenance
    MCP server for full AutoCAD automation, AutoCAD LT automation, and headless DXF generation. It provides 8 consolidated tools for drawing, entity, layer, block, annotation, P&ID, view, and system operations via MCP stdio transport.
    12
    37
    MIT

  • SolidworksMCP

    czuryk
    A
    license
    Not graded
    quality
    A
    maintenance
    MCP server for controlling a live SOLIDWORKS session through the Windows COM API, enabling native CAD operations like sketches, features, bodies, views, and exports, plus transactional plans and vectorization.
    7
    MIT

  • CAD MCP Server

    652036
    A
    license
    C
    quality
    C
    maintenance
    Enables MCP clients to create and edit technical drawings, manage layers and geometry, process GIS/research mapping data, generate previews and layouts, and automate AutoCAD documents on Windows through COM.
    225
    61 npm
    MIT

  • QCAD MCP

    sandraschi
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to automate 2D architectural drafting and CAD file management, including DXF/DWG parsing, SVG/PNG/PDF rendering, wall extrusion to 3D STL meshes, room and beam analysis, block/script library access, and persistent depot storage via a REST API and MCP tools.
    18
    MIT