A surface count sounds like a simple question. It only has a useful answer if the software is looking at the right hull. I built Maxsurf MCP to let a client such as Codex query an open Bentley Maxsurf model and return information I can check against the application itself.
Start with the active design
The bridge uses Windows COM automation. I first ask session_status which applications are running. In one check, the bridge replied while Modeler was closed. That reply told me the server was reachable. To inspect geometry, I still needed to open the file in Modeler, attach to that session and verify the design name.
Once the file is identified, list_surfaces provides a useful first comparison. I check the returned names against the surface tree before moving on to hydrostatics or resistance.
A 49-surface test case
In the release test on Maxsurf 2025, the concept model had 49 separate surfaces. Its section grid contained 43 stations, 20 waterlines and seven buttocks. The test also produced a shaded image in the native application. Together, these checks let me trace the geometry back to the design that supplied it.
The same geometry went into a Holtrop resistance run from 8 to 16 knots. Under the test assumptions, the resistance rose from 56.761 kN to 242.461 kN. Those two points are useful for checking that the transfer and readback worked. I would need to review the empirical method’s range and the vessel’s operating condition before using the curve for a powering decision.
Where I stopped the comparison
The stability check exposed a more consequential issue. With the test’s +1 m vertical centre-of-gravity input, Modeler reported a KG of 3.2 m, while Stability reported approximately 5.2 m. KG is the vertical distance from the keel reference to the centre of gravity. The difference matters because the reference used for KG also affects the interpretation of stability results.
I left the difference unresolved in the verification record. Before carrying a KG or GM value from one module to another, I would establish which datum and sign convention each module used.
The release verification notes record the build, inputs and limits of the test. The bridge and installation instructions are in the public project repository.
Continue to the tutorial: connect to your first Modeler session →
Türkçe metin
Sürüm doğrulamasındaki konsept gövde 49 yüzey, 43 istasyon, 20 su hattı ve 7 batok içeriyordu. Aynı +1 m VCG girdisinde Modeler KG için 3,2 m, Stability yaklaşık 5,2 m verdi. Referans düzlemi ve işaret kuralı doğrulanmadan bu sonuçlar modüller arasında aktarılmamalı.
Bir gövde modelini devraldığımda ilk sorum kaç yüzeyi olduğu ve bu yüzeylerin nasıl adlandırıldığıdır. Maxsurf MCP’yi geliştirirken çıkış noktam bu tür soruları açık tasarıma yöneltebilmekti. Örneğin bir mühendis, bir yüzeyin adını sohbetten sorabilir, yanıtı Modeler’ın yüzey ağacıyla karşılaştırabilir ve incelemeye buradan devam edebilir.
Bir isteğin Maxsurf’e ulaşması
Model Context Protocol (MCP), bir istemcinin hangi araçların kullanılabilir olduğunu öğrenmesini ve bu araçlara yapılandırılmış istek göndermesini sağlar. Maxsurf MCP, Windows üzerinde çalışan Bentley uygulamalarına COM otomasyonu üzerinden erişir. Kullanıcı açık gövdenin yüzeylerini istediğinde istemci list_surfaces aracını çağırır. Dönen listeyi anlamlı kılan, bağlanılan tasarımın gerçekten beklenen dosya olmasıdır.
Geometriden analiz sonuçlarına
Modeler’da yüzeyleri ve referans sistemini incelemek bir başlangıçtır. Bir direnç çalışmasında hız aralığı ve yöntem, bir stabilite çalışmasında ise yükleme durumu ve serbest yüzey etkisi sonucu belirler. İsteklerin hangi modüle, hangi girdilerle yönlendirildiğini kaydetmek iki tasarımın karşılaştırılmasını kolaylaştırır. Örneğin aynı gövde için iki direnç eğrisi farklı çıkıyorsa önce hız birimlerini ve deplasmanı karşılaştırırım.
Bir sonuca ne zaman güvenebilirim?
İlk denememde session_status ile MCP sunucusundan yanıt aldım. Bu kontrolde Modeler kapalıydı ve etkin bir model oturumu yoktu. Dolayısıyla yüzey sayısı ya da hidrostatik sonuç raporlamak için önce uygulamayı açmak ve tasarımı tanımlamak gerekiyordu. Bu ayrım araştırma çalışmalarında önemlidir. Sayısal bir değeri rapora almadan önce birimini, yükleme koşulunu ve Bentley uygulamasındaki karşılığını kontrol ederim.
Projenin yayıma hazırlanan 0.2.0-rc.5 sürümü teknik önizleme aşamasındadır. Kullanılabilen işlemler ve doğrulama kapsamı yetenek tablosunda ve doğrulama kayıtlarında açıklanır. Kaynak kod ve kurulum belgeleri Maxsurf MCP deposunda bulunabilir.
[…] Previous […]