ntopology-mcp
ntopology-mcp
Ein MCP-Server für nTop (ehemals nTopology), der Notebook-Blockgraphen direkt liest und bearbeitet, sie headless über nTop Automate ausführt und die resultierende Geometrie vermisst.
nTop liefert einen offiziellen MCP-Server mit, der ein anderes Problem löst: Er durchsucht nTops Dokumentation. Dieser hier arbeitet mit Ihren Dateien. Die beiden ergänzen sich – deren Server beantwortet „Wie richte ich eine Topologieoptimierung ein?“, dieser richtet eine ein und führt sie aus.
Der dokumentierte Automatisierungspfad (nTop Automate) erwartet, dass Sie ein Notebook von Hand in der GUI aufbauen, einige Eingaben als Variablen freigeben und diese aus einem Skript variieren. Das deckt Parametersweeps ab. Es erlaubt jedoch nicht, einen Block hinzuzufügen, eine Eingabe umzuverdrahten oder einen Graphen umzustrukturieren. Dieser Server kann das, indem er die .ntop-Datei als das behandelt, was sie ist: ein Container, der einen JSON-Blockgraphen enthält.
Werkzeuge
Werkzeug | Beschreibung |
| Version, Abschnitte, Block- und Wertanzahl sowie was die Wurzel auswertet |
| Blöcke mit typisierten Signaturen, Verdrahtung und Literalwerten; filterbar, standardmäßig 200 |
| Hängende Eingaben, doppelte IDs, fehlende Wurzel, Literale ohne Wert, zusätzliche Kanten über einen |
| Skalar, Dateipfad, Vektor, Punkt, Booleschen Wert oder Enum ändern |
| Einen Eingabeslot eines Blocks umverdrahten |
| Einen berechneten Block aus einer typisierten Signatur hinzufügen |
| Eine Konstante hinzufügen |
| Die Wurzel auf ausgewählte Ausgaben zeigen und alles Unerreichbare verwerfen |
| Über |
| Die Blocksignaturen in Ihrer nTop-Installation durchsuchen |
| Volumen, Fläche, Begrenzungsbox, offene und nicht-manifold Kantenanzahl, verbundene Komponenten |
| Festlegen, welchen Block |
| nTops eigene mitgelieferte Beispiel-Notebooks und Referenzseiten durchsuchen |
| Melden, was der Server auf diesem Rechner finden kann |
Related MCP server: Onshape MCP Server
Anforderungen
nTop installiert. Verifiziert gegen 5.54.2 unter Windows.
nTop Automate-Lizenz für
run_notebook. Diese wird separat von der GUI-Sitzung lizenziert; alles andere funktioniert ohne sie.Node.js 20+ zum Ausführen des Servers. Die Testsuite benötigt 21+, wo
node --testeinen Glob akzeptiert.
Installation
git clone https://github.com/sohumsuthar/ntopology-mcp.git
cd ntopology-mcp
npm install
npm run buildKonfiguration
Fügen Sie zu Ihrer MCP-Client-Konfiguration hinzu:
{
"mcpServers": {
"ntopology": {
"command": "node",
"args": ["C:\\path\\to\\ntopology-mcp\\dist\\index.js"],
"env": {
"NTOP_INSTALL_ROOT": "C:\\Program Files\\nTopology\\nTopology"
}
}
}
}NTOP_INSTALL_ROOT ist optional, wenn nTop am Standard-Windows-Speicherort liegt. NTOPCL_PATH kann direkt auf ntopcl.exe zeigen. Rufen Sie zuerst environment auf, um zu bestätigen, was der Server gefunden hat.
Beispiel
Eine bestehende Optimierung auf einen anderen Entwurfsraum ausrichten, auf eine Ausgabekette reduzieren und ausführen:
read_graph notebook=bracket.ntop filter=file_path
set_literal_value notebook=bracket.ntop blockId=477 value={"val": "C:/parts/wedge.step"}
prune_graph notebook=bracket.ntop rootInputs=[900] output=bracket_run.ntop
run_notebook notebook=bracket_run.ntop
mesh_stats path=C:/parts/result.stl listComponents=trueDie Bearbeitungswerkzeuge validieren vor dem Schreiben und weigern sich, einen Graphen mit Fehlern zu speichern, sodass alles, was sie erzeugen, bereits geprüft ist. Führen Sie validate_graph auf Notebooks aus, die dieser Server nicht geschrieben hat – etwa eines, das in der nTop-GUI bearbeitet wurde – bevor Sie Minuten in run_notebook investieren.
Das Notebook-Format
Das .ntop-Format ist von nTop nicht dokumentiert. Das Folgende wurde durch die Untersuchung von Dateien abgeleitet, die von 5.54.2 geschrieben wurden, und der Parser ist durch Round-Tripping echter Notebooks Byte für Byte verifiziert.
file : "MAGIC%$1" u64 sectionCount u64 reserved
sectionCount * { name[16], u64 endOffset }
80 zero bytes, then sections laid out in table order
section : "MAGIC@@9" type[16] name[16] u64 contentLength 80 zero bytes, contentDer Abschnitt main enthält zwei Kinder: fn, den Blockgraphen als JSON, und leaves, einen Objektcontainer, dessen Abschnitt index jeden Literalwert trägt. Ein Block mit nicht leerem func berechnet etwas; ein Block mit leerem func ist ein Literal. Eingaben referenzieren den erzeugenden Block per ID, wobei 0 und -1 beide „nicht verbunden“ bedeuten.
Wissenswertes Verhalten
Diese Punkte kosten echte Debugging-Zeit und sind, wo möglich, in validate_graph oder in Werkzeugbeschreibungen kodiert:
Ein
list<T>-Parameter muss von genau einemcore.list<T>-Block gespeist werden. Das direkte Verdrahten von zwei Impliziten in den List-Slot führt dazu, dass nTop die gesamte Datei beim Laden mit einer generischen „unable to load your file“-Meldung ablehnt, ohne etwas zu benennen.validate_graphfängt die Form ab, die dies in der Praxis erzeugt: verbundene Kanten über die deklarierte Parameteranzahl hinaus an einem Block mit einemlist<T>-Parameter.Zusätzliche nachlaufende unverbundene Eingabeslots sind normal. nTop erzeugt sie selbst, wenn eine Blockversion einen optionalen Parameter erhält, also sind sie kein Fehler.
plane<point,vector,vector>nimmt einen Ursprung und zwei Vektoren, die die Ebene aufspannen. Die Normale ist ihr Kreuzprodukt, nicht das zweite Argument.offset_implicitist umgekehrt zur Intuition: Ein positiver Offset erodiert. Das Abrunden konvexer Kanten (eine morphologische Öffnung) istoffset(+r)gefolgt vonoffset(-r).Der Blend-Enum von
boolean_union:1fügt Material an der Verbindung hinzu,2entfernt es,0ist eine harte Vereinigung.Der dritte Eingang von
implicit_to_meshv2.4.0 ist die minimale Merkmalsgröße. Setzen Sie ihn auf 5 mm und eine 5 mm dicke Platte verschwindet stillschweigend.Das Versionssuffix ist tragend. Die Binärdateien enthalten jede historische Revision eines Blocks, aber nTop registriert nur die aktuelle. Eine alte Revision schlägt mit derselben Meldung „Unknown block … Toolkit or Connector that is not installed“ fehl wie ein nicht lizenziertes Toolkit, sodass eine veraltete Signatur genau wie eine fehlende Lizenz aussieht.
search_blocksgibt die neueste Revision eines Namens zuerst zurück; bevorzugen Sie diese und behandeln Sie eine nackte, unversionierte Form mit Misstrauen.Ein unverbundener Eingang ist
-1(Empty), nicht0(None).0an einem erforderlichen Eingang führt dazu, dass nTop die Datei nicht lädt. Aber-1ist auch nicht universell sicher: Einige optionale Eingänge lehnen es mitInput at N is Empty but optionalab und müssen mit einem Literal gespeist werden. Passen Sie sich an, was das umgebende Notebook bereits tut, und lassen Sievalidate_graphund einen Probelauf den Rest klären.ntopcl -omeldet den Block, der durch den eigenenoutput-Schlüssel des Graphen benannt ist, denset_outputsetzt. Die Eingänge der Wurzelgruppe sind keine Notebook-Ausgaben; ohneset_outputerhalten SieOutput path specified, but can't find output in notebook.Ergebnisblöcke, die Zeitreihen exponieren, sind ab 1 indiziert, und Schritt 1 ist oft eine nicht-physikalische Initialisierung statt der Antwort. Das Lesen erzeugt plausibel aussehenden Unsinn ohne Fehler.
Das Erhalten einer Region während der Optimierung verwendet
passive_region_constraint<region>, gespeist vonfe_region_by_implicit, hinzugefügt zur Optimierungs-Constraint-Liste. Der Eingang „Initial Density“ friert nichts ein – nTop dokumentiert ihn nur als Startschätzung.
nTop liefert eigene Beispiele – lesen Sie diese zuerst
nTop installiert etwa 100 funktionierende Beispiel-Notebooks unter
C:\ProgramData Topology\documentation\ExtendedBlockDocs\ und vollständige HTML-Referenzseiten unter
block-documentationlocks\. find_example durchsucht beide. Ein Beispiel-Notebook klärt die Verdrahtung, Literalformen und Eigenschaftspfade eines Blocks in Sekunden, während das Reverse-Engineering desselben aus Fehlermeldungen Stunden dauert. Prüfen Sie dort zuerst, bevor Sie raten.
Formen von Literalwerten
Literalwerte werden pro Typ gespeichert und die Formen sind nicht einheitlich:
Typ | Wert |
|
|
| Array aus drei solchen Objekten |
|
|
|
|
|
|
|
|
Eine falsche Form schlägt beim Laden mit Leaf failed to deserialize with block/variable <name> fehl.
Blocksignaturen
nTop speichert seine Blocksignaturen als ASCII-Strings in seinen eigenen Binärdateien, einschließlich Revisionen, die nicht mehr registriert sind. search_blocks extrahiert sie zur Laufzeit aus Ihrer Installation und ordnet die neueste Revision jedes Namens zuerst. In diesem Repository sind keine Signaturdaten enthalten – die Signaturen gehören nTop, und dieser Server liest sie aus Ihrer lizenzierten Installation, statt sie weiterzuverteilen.
Einschränkungen
Das Containerformat ist reverse-engineert und nur gegen nTop 5.54.2 verifiziert.
inspect_notebookmeldet die Version, die jede Datei aufzeichnet; behandeln Sie andere Versionen als unverifiziert und halten Sie Backups bereit.Bearbeitungswerkzeuge schreiben an Ort und Stelle, es sei denn, Sie übergeben
output. Sie weigern sich, einen Graphen zu schreiben, der die Validierung nicht besteht, aber sie können nicht wissen, ob eine Bearbeitung semantisch für Ihr Modell richtig ist.run_notebookbenötigt eine nTop-Automate-Lizenz. Ohne eine solche beendet sichntopclnach dem Login und der Fehler wird angezeigt.Praktisch nur Windows, da nTop dort läuft.
Entwicklung
npm run check # type-check src and test
npm test # build, then run the test suite
npm run format:check # Prettier is enforced by config, not by CITests sind eigenständig und benötigen kein nTop. Zwei Suiten erweitern sich, wenn mehr zur Verfügung steht:
NTOP_TEST_NOTEBOOKS– durch Semikolons getrennte.ntop-Pfade, Byte für Byte round-tripped. Dies ist an die von Ihnen angegebenen Pfade gekoppelt, nicht an eine installierte nTop-Installation. Es werden keine Notebooks mit dem Repository geliefert, daher ist die obige Round-Trip-Behauptung eine, die Sie gegen Ihre eigenen Dateien erneut verifizieren sollten, statt sie blind zu übernehmen.Die Katalog-Suite scannt eine echte Installation, wenn eine gefunden wird, und überspringt sie andernfalls.
Lizenz
MIT – siehe LICENSE.
Nicht mit nTop verbunden oder von nTop unterstützt. „nTop“ und „nTopology“ sind Marken des jeweiligen Eigentümers.
Available Tools
14 toolsadd_blockA
Add a computed block. Give the full typed signature from search_blocks. Inputs are source block ids in parameter order; use 0 for an unconnected optional input. A list parameter takes exactly one core.list block.
Inputs: func (required), name (required), type (required), inputs (required), +3 more.
add_literalC
Add a literal block holding a constant. Value shape follows nTop: a length scalar is {"isFinite":true,"units":{"length":1},"val":0.005} in metres, a point is an array of three such objects, an enum is {"enum":0}.
Inputs: name (required), type (required), value (required), notebook (required), +2 more.
environmentB
Report whether ntopcl and an nTop installation were found, and how many block signatures are visible.
Inputs: no named parameters.
find_exampleA
Search nTop's own shipped documentation for a block: working example notebooks and HTML reference pages. Consult this BEFORE reverse-engineering a block's wiring - nTop ships 100+ example .ntop files that show the correct inputs, literal shapes and property paths.
Inputs: query (required), documentationRoot.
inspect_notebookA
Summarise a .ntop notebook: nTop version it was written by, its sections, how many blocks and literal values it holds, and what the root block evaluates.
Inputs: notebook (required).
mesh_statsA
Measure an STL: volume, surface area, bounding box, watertightness and connected components. Use this to check what a notebook actually produced.
Inputs: path (required), listComponents.
prune_graphA
Point the root block at the given outputs and drop every block no longer reachable. Use this to cut a large notebook down to one chain before running it.
Inputs: notebook (required), rootInputs (required), output.
read_graphA
List the blocks in a notebook with their typed signatures, wiring and literal values. Use filter to narrow by block name or signature.
Inputs: notebook (required), limit, filter.
run_notebookB
Execute a notebook headlessly through nTop Automate (ntopcl) and return its errors, warnings and per-block timings. Requires an nTop Automate licence.
Inputs: notebook (required), save, timeoutMs, inputsJson, +1 more.
search_blocksA
Search the block signatures present in the installed nTop binaries. Returns the exact typed signature strings that add_block needs, newest revision of each name first. The binaries retain retired revisions, and nTop rejects those with the same error it gives an unlicensed toolkit - so prefer the highest [version] and distrust a bare unversioned form.
Inputs: query (required), limit, installRoot.
set_inputA
Rewire one input slot of a block to a different source block. Use 0 to disconnect.
Inputs: slot (required), blockId (required), notebook (required), sourceId (required), +1 more.
set_literal_valueC
Set the value of a literal block - a scalar, file path, vector, point, boolean or enum. Writes in place unless output is given.
Inputs: value (required), blockId (required), notebook (required), output.
set_outputA
Choose which block ntopcl reports as the notebook output. Required before run_notebook's outputJson will produce anything - nTop reads the graph's own output key, not the root group's inputs, and answers "can't find output in notebook" when it is unset. Pass -1 to clear.
Inputs: blockId (required), notebook (required), output.
validate_graphA
Check a notebook for problems that stop it loading or building: dangling inputs, duplicate ids, literals with no value, and list parameters wired with several inline edges instead of a core.list block.
Inputs: notebook (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Each tool has a clearly distinct purpose: adding literals vs. setting their values, reading the graph vs. inspecting the notebook, validating vs. running, searching blocks vs. finding examples. No two tools appear to do the same thing, so an agent can reliably pick the right one.
The vast majority of tools follow a consistent verb_noun snake_case pattern (add_literal, search_blocks, set_output). Two exceptions break the pattern: 'mesh_stats' is a noun_noun compound and 'environment' is a bare noun, which slightly reduces predictability but does not cause real confusion.
14 tools is well within the sweet spot for a domain-specific server. Each tool addresses a distinct step in the notebook lifecycle—inspection, editing, validation, execution, and analysis—earning its place without bloat or obvious omission.
The tool surface covers the core workflow: read/inspect/validate, add and modify blocks/literals, rewire inputs, set outputs, run, and check results. Minor gaps exist (e.g., no explicit block deletion, no direct 'save notebook' tool), but existing tools like prune_graph and set_input can work around these without agent failure.
Maintenance
Related MCP Connectors
Control Unreal Engine to browse assets, import content, and manage levels and sequences. Automate…
Manage SysML2 projects; check, evaluate, verify, query, document and diagram models.
Geometry and CAD file metadata extraction for STL, OBJ, PLY, PCD, LAS/LAZ, glTF/GLB.
Formula-backed WorkPaper tools for workbook readback, input edits, and JSON persistence.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables automated control of Ansys Workbench, Mechanical, and MAPDL through scripted journals and batch processing for simulation workflows.107MIT
- FlicenseNot gradedqualityDmaintenanceEnables programmatic CAD modeling with Onshape through document discovery, parametric sketching, feature management, and gear creation.-
- AlicenseNot gradedqualityDmaintenanceEnables building and modifying parametric solid models in a local SOLIDWORKS installation via the COM API.MIT
- FlicenseNot gradedqualityBmaintenanceEnables control of a live SOLIDWORKS session through the Windows COM API, providing native sketch, feature, body, reference-geometry, view, probe, and export operations, along with transactional CAD plans, parametric sketches, multibody tools, and deterministic raster-to-sketch vectorization pipelines.1-