Skip to main content
Glama
ntopology-mcp

ntopology-mcp

by sohumsuthar

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

inspect_notebook

Version, Abschnitte, Block- und Wertanzahl sowie was die Wurzel auswertet

read_graph

Blöcke mit typisierten Signaturen, Verdrahtung und Literalwerten; filterbar, standardmäßig 200

validate_graph

Hängende Eingaben, doppelte IDs, fehlende Wurzel, Literale ohne Wert, zusätzliche Kanten über einen list<T>-Parameter hinaus

set_literal_value

Skalar, Dateipfad, Vektor, Punkt, Booleschen Wert oder Enum ändern

set_input

Einen Eingabeslot eines Blocks umverdrahten

add_block

Einen berechneten Block aus einer typisierten Signatur hinzufügen

add_literal

Eine Konstante hinzufügen

prune_graph

Die Wurzel auf ausgewählte Ausgaben zeigen und alles Unerreichbare verwerfen

run_notebook

Über ntopcl ausführen, mit strukturierten Fehlern, Warnungen und Zeiten pro Block

search_blocks

Die Blocksignaturen in Ihrer nTop-Installation durchsuchen

mesh_stats

Volumen, Fläche, Begrenzungsbox, offene und nicht-manifold Kantenanzahl, verbundene Komponenten

set_output

Festlegen, welchen Block ntopcl -o als Notebook-Ausgabe meldet

find_example

nTops eigene mitgelieferte Beispiel-Notebooks und Referenzseiten durchsuchen

environment

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 --test einen Glob akzeptiert.

Installation

git clone https://github.com/sohumsuthar/ntopology-mcp.git
cd ntopology-mcp
npm install
npm run build

Konfiguration

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=true

Die 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, content

Der 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 einem core.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_graph fängt die Form ab, die dies in der Praxis erzeugt: verbundene Kanten über die deklarierte Parameteranzahl hinaus an einem Block mit einem list<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_implicit ist umgekehrt zur Intuition: Ein positiver Offset erodiert. Das Abrunden konvexer Kanten (eine morphologische Öffnung) ist offset(+r) gefolgt von offset(-r).

  • Der Blend-Enum von boolean_union: 1 fügt Material an der Verbindung hinzu, 2 entfernt es, 0 ist eine harte Vereinigung.

  • Der dritte Eingang von implicit_to_mesh v2.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_blocks gibt 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), nicht 0 (None). 0 an einem erforderlichen Eingang führt dazu, dass nTop die Datei nicht lädt. Aber -1 ist auch nicht universell sicher: Einige optionale Eingänge lehnen es mit Input at N is Empty but optional ab und müssen mit einem Literal gespeist werden. Passen Sie sich an, was das umgebende Notebook bereits tut, und lassen Sie validate_graph und einen Probelauf den Rest klären.

  • ntopcl -o meldet den Block, der durch den eigenen output-Schlüssel des Graphen benannt ist, den set_output setzt. Die Eingänge der Wurzelgruppe sind keine Notebook-Ausgaben; ohne set_output erhalten Sie Output 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 von fe_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

real

{"isFinite":true,"units":{"length":1},"val":0.005} (SI – Meter)

point

Array aus drei solchen Objekten

text

{"string":"inlet"} – nicht {"val":...}

choice

{"choices":["Full Analysis","Potential Flow"],"selected":0}

file_path

{"val":"C:/path/to/file.step"}

unit_length_enum

{"id":"mm"}

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_notebook meldet 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_notebook benötigt eine nTop-Automate-Lizenz. Ohne eine solche beendet sich ntopcl nach 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 CI

Tests 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 tools
add_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

    A3.7/5.0

    Scored across 14 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables building and modifying parametric solid models in a local SOLIDWORKS installation via the COM API.
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
      -