Skip to main content
Glama
SourishSenapati

ADVEKT MCP Server

      _    ____  _   _ _____ _  _______ 
     / \  |  _ \| | | | ____| |/ /_   _|
    / _ \ | | | | | | |  _| | ' /  | |  
   / ___ \| |_| | \_/ | |___| . \  | |  
  /_/   \_\____/ \___/|_____|_|\_\ |_|  

A D V E K T

The Invariant Velocity Field of Continuous Matter

Autonomous Multi-Discipline Chemical & Mechanical Engineering CAE Suite & MCP Engine
Direct Kernel COM Automation • Headless Linux First-Principles Solvers • Native RAEBYES Invariant Protection

Python MCP CLI Tests RAEBYES License

Project Ref: FNQ-PR-2026-001 • Lead Chemical & Process Engineer: Sourish Senapati (FinnoaQ Agro-Industrial Technologies Ltd.)
License: ADVEKT Commercial & Intellectual Property Protection License v1.0 (Free for Personal & Academic Use / Commercial License Required)


1. The Core Manifesto: Ground-Truth Engineering Over Token Guessing

Large Language Models hallucinate numbers. In web applications or copy generation, a hallucinated token is an inconvenience. In high-pressure chemical plants, steam boiler headers, and rotating machinery, an unverified number is a catastrophic structural explosion.

Superficial AI coding assistants ("vibe coders") substitute hard engineering reality with synthetic mock arrays, fabricated pressure drops, and fictitious yields.

ADVEKT eliminates hallucination through three inviolable architectural tenets:

  1. Direct Software COM Automation: On Windows, ADVEKT bypasses text simulation entirely. It directly manipulates running instances of licensed CAD/CAE software (SolidWorks 2025, Aspen Plus V14, Aspen HYSYS, AutoCAD 2025, CHEMCAD, PRO/II) via official OLE/COM API dispatch tables.

  2. Pure Linux First-Principles Solvers: On cloud containers and Linux clusters where proprietary Windows software is absent, ADVEKT dispatches exact, analytical, first-principles solvers (ASME Section VIII Div 1 pressure vessels, Colebrook-White implicit hydraulics, ASME STEAM-TA steam tables, Peng-Robinson Cubic EOS with analytical Cardano roots, TEMA Kern heat exchangers).

  3. Hardwired Invariant Circuit Breaking: Integrated natively with SourishSenapati/RAEBYES. If an AI agent attempts to output a mass balance with closure error $\delta_{\text{mass}} \ge 10^{-4}$ or flat synthetic arrays ($\mathrm{Var}(\mathbf{X}) < 10^{-6}$), the circuit breaker trips instantly, aborting execution before corrupted parameters enter manufacturing drawings or capital expenditure schedules.


Related MCP server: solidworks-mcp

2. System Architecture

                    ┌────────────────────────────────────────────────────────┐
                    │                      A D V E K T                       │
                    │      The Invariant Velocity Field of Continuous Matter │
                    └───────────────────────────┬────────────────────────────┘
                                                │
                 ┌──────────────────────────────┴──────────────────────────────┐
                 ▼                                                             ▼
   ┌───────────────────────────┐                                 ┌───────────────────────────┐
   │    HIGH-PERFORMANCE CLI   │                                 │     MCP SERVER ENGINE     │
   │      (21 Executables)     │                                 │     (60 Tools JSON-RPC)   │
   ├───────────────────────────┤                                 ├───────────────────────────┤
   │  • advekt status (<0.2s)  │                                 │  • Claude Desktop         │
   │  • solidworks-cli         │                                 │  • Cursor / Antigravity   │
   │  • aspen-plus-cli / hysys │                                 │  • Gemini CLI / Copilot   │
   │  • thermo-cli / pv-cli    │                                 │  • Non-blocking Stdio     │
   │  • hydraulics / thermal   │                                 │  • Zero zombie processes  │
   └─────────────┬─────────────┘                                 └─────────────┬─────────────┘
                 │                                                             │
                 └──────────────────────────────┬──────────────────────────────┘
                                                ▼
     ┌──────────────────────────────────────────────────────────────────────────────────┐
     │                     THE 17 ENGINEERING DISCIPLINES & SOLVERS                     │
     ├────────────────────────────────────────┬─────────────────────────────────────────┤
     │  Windows COM Automation (Live Apps):   │  Native Linux / POSIX Solvers (No COM): │
     │  • Dassault Systèmes SOLIDWORKS 2025   │  • ASME STEAM-TA / PR-EOS Thermo        │
     │  • Aspen Technology Aspen Plus V14     │  • ASME B36.10M / Crane TP 410 Flow     │
     │  • Aspen Technology Aspen HYSYS        │  • TEMA / Kern Heat Exchanger Rating    │
     │  • Chemstations CHEMCAD v7/v8          │  • ASME BPVC Section VIII Div 1 PV      │
     │  • AVEVA SimSci PRO/II                 │  • Cantera Reaction Kinetics (Arrhenius)│
     │  • Autodesk AutoCAD 2025               │  • DWSIM Open-Source Flowsheet XML      │
     │  • Honeywell UniSim Design             │  • COMSOL & Ansys Fluent Headless Audits│
     └────────────────────────────────────────┴─────────────────────────────────────────┘
                                                │
                                                ▼
     ┌──────────────────────────────────────────────────────────────────────────────────┐
     │                     NATIVE RAEBYES CIRCUIT BREAKER INTEGRATION                   │
     │       Strict Invariant Enforcement: Zero Mass & Energy Closure Error (< 1e-4)    │
     │       Non-Blocking Diagnostics: ROT inspection in < 0.2s | Memory-Leak Free      │
     └──────────────────────────────────────────────────────────────────────────────────┘

3. Quickstart (Under 60 Seconds)

Installation

# Clone the repository
git clone https://github.com/SourishSenapati/ADVEKT.git
cd ADVEKT

# Install in editable mode
pip install -e .

# Or install with developer test dependencies
pip install -e ".[dev]"

Instant Diagnostic Status

# Non-blocking status check across all 17 engineering subsystems in < 0.2s
advekt status

Model Context Protocol (MCP) Setup

Connect ADVEKT to your AI agent environment:

  • Claude Desktop (claude_desktop_config.json):

    {
      "mcpServers": {
        "advekt": {
          "command": "advekt-mcp",
          "args": []
        }
      }
    }
  • Cursor (.cursor/settings.json):

    {
      "cursor.mcpServers": {
        "advekt": {
          "command": "python",
          "args": ["-m", "agentic_chemeng.mcp.server"]
        }
      }
    }

4. Subsystem Matrix & Technical Standards

Subsystem

Underlying Engine

Key Capabilities

Standards / Formats

Platform Support

SolidWorks

Dassault Systèmes SOLIDWORKS 2025 SP1.2 (SldWorks.Application)

Parametric 3D solid modeling, feature tree traversal, assembly constraints, mass properties, high-res viewport rendering, STEP/PDF export

.SLDPRT, .SLDASM, .SLDDRW, .STEP, B-Rep solid math

Windows (COM Automation)

Aspen Plus

Aspen Technology Aspen Plus V14 (Apwn.Document OLE Services)

Rigorous flowsheet topology inspection, stream balance extraction, unit block duty schedules, live solver execution (Run2), offline converged audit

.bkp, .apw, .inp, ASME STEAM-TA, NRTL, ELECNRTL

Windows (COM) + Linux (Offline Audit)

Aspen HYSYS

Aspen Technology Aspen HYSYS (HYSYS.Application COM)

Dynamic & steady-state hydrocarbon/chemical flowsheets, material/energy streams, unit operations, property packages

.hsc, Peng-Robinson, Sour PR, SRK, Glycol, Amines

Windows (COM) + Linux (Offline Case Parsing)

CHEMCAD

Chemstations CHEMCAD v7/v8 (CHEMCAD.Application COM)

Chemical process flowsheet inspection, unit operations, streams, and batch distillation modeling

.ccx, .cc5, .cc6, NRTL, UNIQUAC, Peng-Robinson

Windows (COM) + Linux (Offline XML/CCX)

PRO/II

AVEVA SimSci PRO/II (PROII.Application COM)

Refinery, gas processing, and petrochemical flowsheet simulation and archive inspection

.prz, .pr2, .inp, SRK, Peng-Robinson, Grayson-Streed

Windows (COM) + Linux (Offline PRZ Parsing)

Cantera

Cantera Chemical Physics Suite (Open-Source)

Chemical reaction kinetics (Arrhenius law), multi-component gas transport properties (Sutherland viscosity, thermal conductivity), Gibbs equilibrium

Cantera YAML / XML / CTI, Kinetic Theory of Gases

Native Cross-Platform (Linux, macOS, Windows)

UniSim Design

Honeywell UniSim Design (UniSimDesign.Application COM)

Refining, gas processing, and petrochemical flowsheet inspection and property packages

.usc, .hsc, Peng-Robinson, Kabadi-Danner

Windows (COM) + Linux (Offline Inspection)

Siemens gPROMS

Siemens / PSE gPROMS ProcessBuilder & ModelBuilder

Advanced equation-oriented process modeling, distributed systems (PDEs/DAEs), dynamic simulation, parameter estimation

.gPJ, .gPA, .xml, Custom DAEs, Catalytic / Polymer Systems

Windows (COM/CLI) + Linux (Offline Parsing)

COMSOL Multiphysics

COMSOL Multiphysics Suite

Chemical reaction engineering (cheq), transport of diluted/concentrated species (tds/tcs), heat transfer in fluids (ht), laminar flow (spf)

.mph, Finite Element Analysis, Multiphysics Coupling

Native Headless Inspection (Linux, macOS, Windows) + Batch CLI

Ansys Fluent & CFX

Ansys Fluent & CFX Fluid Dynamics

Reacting flow CFD, finite-rate combustion kinetics, multi-component species transport, multiphase Eulerian/VOF/DPM

.cas, .cas.gz, .cas.h5, .def, .cfx, .jou

Native Headless Inspection (Linux & Windows) + Batch Journal Solver

DWSIM

DWSIM Open-Source Simulator (v8/v9)

Open-source process simulation, CAPE-OPEN thermodynamics, XML flowsheet inspection, Rachford-Rice VLE flash

.dwsim, .dwxml, CoolProp, UNIFAC, IAPWS-IF97

Native Cross-Platform (Linux & Windows)

AutoCAD

Autodesk AutoCAD 2025 (AutoCAD.Application & accoreconsole.exe)

Automated P&ID and General Arrangement drafting, title block verification, layer auditing, headless DWG-to-PDF/DXF batch conversion

.dwg, .dxf, Vector PDF, ANSI/ISO title blocks

Windows (COM & accoreconsole)

Thermodynamics

First-Principles Thermodynamics Engine

High-precision steam tables (ASME STEAM-TA / IAPWS-95 6-term), Peng-Robinson Cubic Equation of State (PR-EOS), analytical Cardano cubic root solver, fugacity coefficients, Wagner/Antoine vapor pressure

ASME 1967 Steam Tables, IAPWS Industrial Formulation, PR (1976)

Native Cross-Platform (Pure Python / No COM Required)

Process Hydraulics

First-Principles Hydraulics Engine

Darcy-Weisbach head loss, Colebrook-White friction factor (Newton-Raphson), ASME B36.10M standard pipe schedules, Crane TP 410 minor losses, Pump TDH, NPSHa, motor sizing

ASME B36.10M, Crane TP 410, Hydraulic Institute (HI)

Native Cross-Platform (Pure Python / No COM Required)

Thermal Design

Industrial Heat Transfer Engine

TEMA E shell-and-tube heat exchanger rating (Kern method), LMTD & $F_T$ configuration correction, MVR falling-film evaporator mass/energy balances, compressor power & specific energy

TEMA 10th Ed Class C/R, Kern Method, MVR Industrial Design

Native Cross-Platform (Pure Python / No COM Required)

Pressure Vessels

ASME Section VIII Div 1 Mechanical Engine

UG-27(c)(1) cylindrical shell thickness under internal pressure, UG-32(d) 2:1 ellipsoidal heads, UG-32(e) torispherical heads, UG-37 nozzle opening area replacement, UG-99 hydrostatic test pressure

ASME BPVC Section VIII Div 1, ASME Section II Part D

Native Cross-Platform (Pure Python / No COM Required)

RAEBYES Protocol

Invariant Circuit Breaker Daemon

Strict mass/energy conservation enforcement ($\delta < 10^{-4}$), array/tensor variance floor auditing ($\mathrm{Var}(\mathbf{X}) \ge 10^{-6}$), process crash recovery

Circuit breaker tripping, tamper-evident JSON audit trail

Native Cross-Platform (Pure Python / No COM Required)


5. The 60 Registered Model Context Protocol (MCP) Tools

Mechanical CAD & Automated Drafting (12 Tools)

  • SolidWorks 2025 (9 tools):

    1. solidworks_get_status: Inspect COM registration, ROT running instance, and version.

    2. solidworks_open_document: Open .SLDPRT, .SLDASM, or .SLDDRW with silent configuration options.

    3. solidworks_close_document: Close active document with optional save.

    4. solidworks_inspect_model: Extract feature tree, solid bodies, custom metadata, and units.

    5. solidworks_get_mass_properties: Compute mass (kg), volume ($m^3$), surface area ($m^2$), and Center of Gravity (CoG).

    6. solidworks_force_rebuild: Trigger top-level parametric assembly/part rebuild.

    7. solidworks_render_view: Render high-resolution isometric, front, or top viewport to PNG.

    8. solidworks_export_cad: Export native geometry to .STEP (AP203/AP214) or drawing to vector .PDF.

    9. solidworks_execute_script: Dispatch custom VBScript / VBA macro into SolidWorks kernel.

  • Autodesk AutoCAD 2025 (3 tools):

    1. autocad_get_status: Inspect AutoCAD COM server and accoreconsole.exe availability.

    2. autocad_plot_pdf: Headless batch vector plot of .DWG layout to PDF.

    3. autocad_run_script: Execute batch AutoLISP (.lsp) or command script (.scr).

Chemical Process Simulation & Flowsheeting (23 Tools)

  • Aspen Plus V14 (6 tools):

    1. aspen_plus_get_status: Verify Aspen Plus COM registration and active licenses.

    2. aspen_plus_open_simulation: Load .bkp, .apw, or .inp case.

    3. aspen_plus_inspect_flowsheet: Extract complete flowsheet topology, streams, and unit blocks.

    4. aspen_plus_get_stream_table: Extract converged stream balance table (T, P, mass flow, vapor fraction).

    5. aspen_plus_get_block_data: Extract block-level duty schedules, heat transfer rates, and separation parameters.

    6. aspen_plus_run_simulation: Dispatch flowsheet solver calculation run.

  • Aspen HYSYS (4 tools):

    1. aspen_hysys_get_status: Check HYSYS COM server connection.

    2. aspen_hysys_open_case: Open .hsc simulation archive.

    3. aspen_hysys_inspect_case: Extract streams, property packages, and flowsheet structure.

    4. aspen_hysys_solve: Trigger steady-state or dynamic case solve.

  • Chemstations CHEMCAD v7/v8 (3 tools):

    1. chemcad_get_status: Verify CHEMCAD COM server availability.

    2. chemcad_inspect_flowsheet: Inspect unit operations, streams, and batch distillation setups.

    3. chemcad_run_simulation: Trigger flowsheet convergence run.

  • AVEVA SimSci PRO/II (3 tools):

    1. proii_get_status: Verify PRO/II COM registration.

    2. proii_inspect_flowsheet: Inspect flowsheet and thermodynamic components.

    3. proii_run_simulation: Execute PRO/II batch calculation.

  • Honeywell UniSim Design (2 tools):

    1. unisim_get_status: Check UniSim COM server registration.

    2. unisim_inspect_case: Inspect simulation case (.usc, .hsc).

  • DWSIM Simulator (3 tools):

    1. dwsim_get_status: Verify DWSIM executable, CAPE-OPEN libraries, and CoolProp bindings.

    2. dwsim_inspect_flowsheet: Parse .dwsim / .dwxml XML topology without running GUI.

    3. dwsim_flash_calculation: Perform isothermal/isobaric Rachford-Rice vapor-liquid flash.

  • Cantera Chemical Kinetics (3 tools):

    1. cantera_get_status: Verify Cantera chemical physics environment.

    2. cantera_arrhenius_kinetics: Calculate forward/reverse rate coefficients via Arrhenius parameters.

    3. cantera_gas_transport_properties: Calculate multi-component Sutherland viscosity and thermal conductivity.

Advanced Multiphysics & CFD Solvers (9 Tools)

  • Siemens gPROMS (3 tools):

    1. gproms_get_status: Verify gPROMS ProcessBuilder/ModelBuilder CLI.

    2. gproms_inspect_project: Inspect .gPJ, .gPA, or .xml project hierarchy and DAE/PDE equations.

    3. gproms_run_simulation: Dispatch dynamic simulation or parameter estimation run.

  • COMSOL Multiphysics (3 tools):

    1. comsol_get_status: Check COMSOL batch engine and license.

    2. comsol_inspect_model: Extract physics interfaces (cheq, tds, ht, spf), meshes, and study nodes from .mph.

    3. comsol_run_study: Dispatch headless batch parametric sweep or study solve.

  • Ansys Fluent & CFX (3 tools):

    1. ansys_get_status: Inspect Ansys environment variables (AWP_ROOT) and fluent solvers.

    2. ansys_inspect_case: Inspect .cas / .cas.gz mesh dimensions and boundary conditions.

    3. ansys_run_journal: Dispatch headless CFD calculation via .jou journal script.

First-Principles Engineering & Invariants (15 Tools)

  • Thermodynamics Engine (2 tools):

    1. thermo_steam_properties: High-precision ASME STEAM-TA / IAPWS steam tables (T, P, h, s, v, $\rho$, latent heat).

    2. thermo_peng_robinson_eos: Peng-Robinson Cubic EOS (Cardano analytical root solver, Z factor, fugacity coefficients).

  • Process Hydraulics (3 tools):

    1. hydraulics_pipe_dimensions: Query ASME B36.10M / B36.19M pipe dimensional schedules (DN, OD, ID, thickness).

    2. hydraulics_pressure_drop: Darcy-Weisbach head loss with Colebrook-White friction factor (Newton-Raphson).

    3. hydraulics_pump_head_npsha: Total Dynamic Head (TDH), NPSHa, hydraulic power, and motor rating.

  • Industrial Thermal Design (3 tools):

    1. thermal_lmtd_calculation: Logarithmic Mean Temperature Difference with multi-pass $F_T$ configuration correction.

    2. thermal_rate_tema_shell_and_tube: Kern method rating for TEMA E shell-and-tube heat exchangers.

    3. thermal_mvr_evaporator_design: Mechanical Vapor Recompression falling-film evaporator mass/energy balances and compressor power.

  • ASME Pressure Vessels (4 tools):

    1. pv_asme_ug27_shell: ASME BPVC Section VIII Div 1 UG-27(c)(1) cylindrical shell thickness & MAWP under internal pressure.

    2. pv_asme_ug32_head: ASME Section VIII Div 1 UG-32 2:1 ellipsoidal and torispherical formed heads.

    3. pv_asme_ug37_nozzle: ASME Section VIII Div 1 UG-37 nozzle opening area replacement & reinforcement limits.

    4. pv_asme_ug99_hydro: ASME Section VIII Div 1 UG-99(b) hydrostatic proof test pressure.

  • RAEBYES Invariant Circuit Breaker (3 tools):

    1. raebyes_verify_simulation_variance: Guard against synthetic flat arrays ($\mathrm{Var}(\mathbf{X}) \ge \sigma^2_{\min}$).

    2. raebyes_verify_conservation_invariants: Enforce mass balance closure ($\delta_{\text{mass}} < 10^{-4}$).

    3. raebyes_get_circuit_breaker_status: Read circuit breaker state, trip history, and diagnostic logs.


6. Governing Equations & Mathematical Formulations

1. ASME Section VIII Division 1 Pressure Vessel Mechanics

Under internal design pressure $P$, nominal design stress $S$, joint efficiency $E$, inside radius $R$, and corrosion allowance $t_c$:

  • Cylindrical Shell (UG-27(c)(1)): $$t = \frac{P R}{S E - 0.6 P} + t_c, \quad \text{MAWP} = \frac{S E t}{R + 0.6 t}$$

  • 2:1 Ellipsoidal Formed Head (UG-32(d)): $$t = \frac{P D K}{2 S E - 0.2 P} + t_c \quad \text{where } K = \frac{1}{6}\left[2 + \left(\frac{D}{2h}\right)^2\right] = 1.0 \text{ for } \frac{D}{2h} = 2.0$$

  • Torispherical Head (UG-32(e)): $$t = \frac{0.885 P L}{S E - 0.1 P} + t_c \quad (L = \text{inside crown radius})$$

  • Nozzle Opening Reinforcement (UG-37): $$A_{\text{req}} = d \cdot t_r \cdot F$$ $$A_{\text{avail}} = A_1 (\text{excess shell}) + A_2 (\text{excess nozzle neck}) + A_4 (\text{weld fillets})$$ $$\text{Enforced Invariant Constraint: } A_{\text{avail}} \ge A_{\text{req}}$$

  • Hydrostatic Proof Test Pressure (UG-99(b)): $$P_{\text{test}} = 1.3 \cdot P_{\text{design}} \cdot \left(\frac{S_{\text{test}}}{S_{\text{design}}}\right)$$

2. Fluid Dynamics & Process Hydraulics

  • Darcy-Weisbach Head Loss: $$\Delta h_f = f \frac{L}{D} \frac{v^2}{2g}, \quad \Delta P_f = \rho g \Delta h_f$$

  • Implicit Colebrook-White Friction Factor: $$\frac{1}{\sqrt{f}} = -2.0 \log_{10} \left( \frac{\epsilon / D}{3.7} + \frac{2.51}{\text{Re} \sqrt{f}} \right)$$ Solved via 6-iteration Newton-Raphson down to $|f_{k+1} - f_k| < 10^{-8}$.

  • Total Dynamic Head (TDH) & Net Positive Suction Head Available (NPSHa): $$\text{TDH} = (z_{\text{disch}} - z_{\text{suct}}) + \frac{P_{\text{disch}} - P_{\text{suct}}}{\rho g} + \Delta h_{f,\text{total}}$$ $$\text{NPSHa} = \frac{P_{\text{suct,abs}} - P_v}{\rho g} + z_{\text{suct}} - h_{f,\text{suction}}$$ $$P_{\text{elec}} = \frac{\rho g Q \cdot \text{TDH}}{\eta_{\text{pump}} \eta_{\text{motor}}}$$

3. High-Precision Thermodynamics

  • Peng-Robinson Cubic Equation of State (1976): $$P = \frac{R T}{v - b} - \frac{a(T)}{v(v + b) + b(v - b)}$$ In cubic polynomial form for compressibility factor $Z$: $$Z^3 - (1 - B) Z^2 + (A - 3B^2 - 2B) Z - (AB - B^2 - B^3) = 0$$ Solved via closed-form analytical Cardano cubic root algorithm. Identifies liquid roots ($Z_L = \min Z$), vapor roots ($Z_V = \max Z$), and calculates component fugacity coefficients $\ln \phi_i$.

4. Industrial Thermal Design

  • TEMA E Shell-and-Tube Exchanger (Kern Method): $$Q = U_o A_o \Delta T_{lm} F_T$$ $$\Delta T_{lm} = \frac{(T_{h,\text{in}} - T_{c,\text{out}}) - (T_{h,\text{out}} - T_{c,\text{in}})}{\ln\left(\frac{T_{h,\text{in}} - T_{c,\text{out}}}{T_{h,\text{out}} - T_{c,\text{in}}}\right)}$$

  • Mechanical Vapor Recompression (MVR) Evaporator Balances: $$\dot{m}{\text{evap}} = \dot{m}{\text{feed}} \left(1 - \frac{x_{\text{feed}}}{x_{\text{prod}}}\right)$$ $$W_{\text{comp}} = \frac{\dot{m}{\text{evap}} R T_1}{\eta{\text{isen}} \frac{\gamma - 1}{\gamma}} \left[ \left(\frac{P_2}{P_1}\right)^{\frac{\gamma - 1}{\gamma}} - 1 \right]$$

5. RAEBYES Invariant Circuit Breaker Criteria

  • Mass Balance Conservation Invariant: $$\delta_{\text{mass}} = \frac{\left|\sum \dot{m}{\text{in}} - \sum \dot{m}{\text{out}}\right|}{\sum \dot{m}{\text{in}}} < \epsilon{\text{tol}} \quad (\epsilon_{\text{tol}} = 10^{-4})$$

  • Synthetic Variance Floor Check (Flat Array Detection): $$\mathrm{Var}(\mathbf{X}) = \frac{1}{N} \sum_{i=1}^N (x_i - \bar{x})^2 \ge \sigma^2_{\min} \quad (\sigma^2_{\min} = 10^{-6})$$


7. Command-Line Interface (CLI) Guide

1. Master Subsystem Gateway (advekt)

# Execute sub-200ms non-blocking status inquiry across all 17 engineering subsystems
advekt status

# Start Model Context Protocol (MCP) JSON-RPC 2.0 stdio server
advekt mcp

2. High-Precision Thermodynamics (thermo-cli)

# Saturated steam properties at 160.0°C (ASME STEAM-TA / IAPWS Formulation)
thermo-cli steam --temp 160.0

# Superheated steam properties at 40 bar, 500°C
thermo-cli steam --pressure 40.0 --temp 500.0

# Peng-Robinson Cubic EOS flash for hydrocarbon mixture
thermo-cli pr-eos --compounds methane,ethane,propane --fractions 0.7,0.2,0.1 --temp 30.0 --pressure 45.0

3. Process Hydraulics & Pumps (hydraulics-cli)

# Query ASME B36.10M standard pipe dimensions (DN 100 Sch 40)
hydraulics-cli pipe-dims 100 --schedule sch40

# Darcy-Weisbach pressure drop across 120m carbon steel line
hydraulics-cli pressure-drop --flow 45.0 --dn 100 --length 120.0 --roughness 0.045

# Centrifugal pump Total Dynamic Head (TDH), NPSHa, and motor rating
hydraulics-cli pump --flow 45.0 --static-head 15.0 --p-disch 3.5 --p-suct 0.2

4. Industrial Thermal Design (thermal-cli)

# Calculate LMTD and multi-pass configuration correction factor FT
thermal-cli lmtd --th-in 120.0 --th-out 80.0 --tc-in 30.0 --tc-out 60.0 --passes 2

# Rate TEMA E Shell-and-Tube heat exchanger via Kern method
thermal-cli shell-and-tube --duty 450.0 --th-in 120.0 --th-out 80.0 --tc-in 30.0 --tc-out 60.0 --tubes 240 --length 4.0

# Design MVR Falling Film Evaporator (area, compressor power, specific energy)
thermal-cli mvr --feed-flow 1500.0 --feed-solids 5.0 --product-solids 35.0 --temp 80.0

5. ASME Section VIII Div 1 Pressure Vessels (pv-cli)

# Cylindrical shell wall thickness & MAWP (UG-27)
pv-cli shell --pressure 10.0 --diameter 1200.0 --temp 120.0 --material "SA-240 316L" --joint-eff 1.0 --corrosion 1.5

# 2:1 Ellipsoidal dished head thickness (UG-32)
pv-cli head --pressure 10.0 --diameter 1200.0 --type ellipsoidal_2_1 --material "SA-240 316L"

# Nozzle opening reinforcement check (UG-37)
pv-cli nozzle --vessel-id 1200.0 --shell-t 10.0 --nozzle-od 168.3 --nozzle-t 7.11 --pressure 10.0

# Hydrostatic proof test pressure calculation (UG-99)
pv-cli hydro --pressure 10.0 --temp 120.0 --material "SA-240 316L"

6. RAEBYES Invariant Circuit Breaker (raebyes-chemeng-cli)

# Inspect circuit breaker trip state and telemetry
raebyes-chemeng-cli status

# Verify strict mass conservation invariant (< 1e-4 closure error)
raebyes-chemeng-cli check-mass --inflow 1500.0 --outflow 1500.02 --tol 1e-4

# Audit numerical array against flat synthetic mock detection
raebyes-chemeng-cli check-variance --values "10.2, 12.5, 14.8, 18.2, 22.0" --min-var 1e-6

7. Dassault Systèmes SOLIDWORKS (solidworks-cli)

# Check SolidWorks connection status
solidworks-cli status

# Inspect 3D CAD model (features, bodies, custom properties, mass)
solidworks-cli inspect "path/to/vessel.sldprt"

# Compute mass properties (mass, volume, center of gravity)
solidworks-cli mass-props "path/to/assembly.sldasm"

# Render high-resolution isometric view to PNG
solidworks-cli render "path/to/part.sldprt" --view iso --out render.png

# Export CAD model to STEP and PDF
solidworks-cli export "path/to/part.sldprt" --formats step,pdf

8. Aspen Plus V14 (aspen-plus-cli)

# Check Aspen Plus COM registration and licensing state
aspen-plus-cli status

# Open simulation case
aspen-plus-cli open "path/to/plant.bkp"

# Inspect flowsheet topology, streams, and unit blocks
aspen-plus-cli inspect

# Retrieve converged stream balance table (T, P, mass flow, vapor fraction)
aspen-plus-cli streams

8. Python SDK Direct API

In addition to CLI and MCP, advekt provides direct first-class Python bindings:

import advekt

# 1. High-Precision ASME Steam Tables (IAPWS Formulation)
steam = advekt.thermo.calculate_steam_properties(temperature_C=160.0, pressure_bar=6.18)
print(f"Latent Heat (h_fg): {steam['latent_heat_hfg_kJ_kg']} kJ/kg")
print(f"Liquid Density:     {steam['liquid_density_kg_m3']} kg/m³")

# 2. Process Hydraulics (Darcy-Weisbach & Colebrook-White)
hyd = advekt.hydraulics.calculate_pressure_drop(
    flow_m3_h=45.0,
    dn_mm=100,
    length_m=120.0,
    roughness_mm=0.045
)
print(f"Darcy Friction Factor: {hyd['darcy_friction_factor']:.5f}")
print(f"Pressure Drop:         {hyd['pressure_drop_bar']:.3f} bar")

# 3. ASME Section VIII Div 1 Cylindrical Shell
shell = advekt.pressure_vessel.calculate_ug27_shell(
    design_pressure_bar=10.0,
    inside_diameter_mm=1200.0,
    design_temp_C=120.0,
    material="SA-240 316L",
    joint_efficiency=1.0,
    corrosion_allowance_mm=1.5
)
print(f"Required Thickness:    {shell['required_thickness_mm']:.2f} mm")
print(f"Calculated MAWP:       {shell['mawp_bar']:.2f} bar")

# 4. RAEBYES Physical Invariant Protection
guard = advekt.raebyes.verify_conservation_invariants(
    total_inflow_kg_h=1500.0,
    total_outflow_kg_h=1500.02,
    tolerance=1e-4
)
assert guard["passed"] is True, "Circuit breaker tripped: mass balance closure violated!"

9. Low-Spec Optimization & Linux Resilience

advekt is engineered from first principles to prevent crashes across Linux, macOS, Windows, and legacy machines with low RAM:

  • Full Linux / POSIX Isolation: Dynamic platform detection (sys.platform == 'win32') ensures Windows COM (pywin32) calls are bypassed cleanly on Linux and cloud containers without import errors. First-principles thermodynamics, hydraulics, thermal design, pressure vessels, and Cantera run 100% natively on Linux.

  • Sub-200ms Non-Blocking Status: Querying system health (advekt status) tests active Running Object Table (ROT) registrations and OS registry keys in $< 0.2$ s without launching heavy 4 GB CAD/CAE applications into RAM.

  • Wall-Clock Timeout Guardians: Every external solver process is wrapped in run_with_timeout(). If a slow hard drive or modal popup stalls execution, the process is safely aborted after a threshold (default: 20s).

  • Deterministic Garbage Collection: Explicit gc.collect() and COM pointer releases prevent memory accumulation. cleanup_stale_processes() kills orphan background workers on both Windows (taskkill) and Linux (pkill).


10. Intellectual Property Ownership, Commercial Licensing & Monetization

ADVEKT is released under the ADVEKT Source-Available Commercial & Intellectual Property Protection License v1.0 (LICENSE).

1. 100% Retained Intellectual Property

All intellectual property, copyrights, patent rights, trade dress, trademarks, and trade secrets in ADVEKT (advekt), its 60 MCP tools, 21 CLI executables, and mathematical solvers are exclusively and solely owned by Sourish Senapati (FinnoaQ Agro-Industrial Technologies Ltd.). No transfer of IP is granted.

2. Free for Personal, Non-Commercial & Academic Research

You are free to inspect, download, test, benchmark, and evaluate ADVEKT for individual personal projects, non-profit academic research, and classroom education without charge.

3. Strict Commercial & Paid Product Restriction (Monetization Protection)

  • Anti-Parasitic & Paid Wrapper Clause: If any third party, startup, corporation, or individual launches, sells, markets, hosts, or monetizes any paid product, commercial software bundle, SaaS platform, agent-as-a-service, paid API wrapper, or consulting deliverable that incorporates, embeds, or derives from ADVEKT (in whole or in part), you are legally required to obtain a Commercial License and execute a formal revenue-sharing / royalty agreement with Sourish Senapati prior to launch or commercial distribution.

  • Remedies for Unlicensed Commercial Exploitation: Willful commercial infringement entitles Sourish Senapati to immediate injunctive relief, full disgorgement of all gross commercial revenues and subscriber proceeds, statutory damages, and mandatory legal fee reimbursement.

4. Commercial & Enterprise Licensing Inquiries

For commercial licensing, enterprise multi-seat deployment, OEM bundling, proprietary process bindings, or revenue-sharing agreements, contact:

  • Lead Chemical & Process Engineer / IP Owner: Sourish Senapati

  • Email: sourishsenapati791@gmail.com / engineering@finnoaq.com

  • Entity: FinnoaQ Agro-Industrial Technologies Ltd.

  • Project Reference: FNQ-PR-2026-001


11. Technical Standards Attribution

  • Lead Chemical & Process Engineer: Sourish Senapati (FinnoaQ Agro-Industrial Technologies Ltd.)

  • Governing Project Reference: FNQ-PR-2026-001

  • Thermodynamic Standards: ASME STEAM-TA (1967 Formulation), IAPWS Industrial Formulation (1997), Peng-Robinson Cubic Equation of State (1976).

  • Hydraulic Standards: ASME B36.10M / B36.19M Welded and Seamless Wrought Steel Pipe, Crane Technical Paper No. 410, Hydraulic Institute (HI) Standards.

  • Thermal Standards: Tubular Exchanger Manufacturers Association (TEMA 10th Edition), Kern Method.

  • Mechanical Standards: ASME Boiler and Pressure Vessel Code (BPVC) Section VIII Division 1 (Rules for Construction of Pressure Vessels), Section II Part D (Materials - Properties).

  • Circuit Breaker Protocol: SourishSenapati/RAEBYES.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to control a running SOLIDWORKS session through its COM API, with tools for sketching, feature creation, assemblies, and visual feedback via screenshots.
    22
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to build, measure, verify, and correct parametric SolidWorks parts and assemblies locally via the COM API, supporting operations like sketching, extruding, modeling, dimensioning, material assignment, export, and assembly mating.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Let AI agents build, measure and verify parametric parts and assemblies in your own running SolidWorks (Windows, COM). 46 tools, every step measured.
    87
    674 PyPI
    19
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents such as Claude to drive SolidWorks through its COM API using natural language, creating parts and assemblies, sketching geometry, and adding features without clicking menus. Also supports running arbitrary API scripts and verifying results through model reports, rendered views, interference checks, and exports.
    1
    MIT