nexus3d
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Nexus 3D Scene Studio
Pure-Python parametric 3D geometry synthesizer, Marching Tetrahedra SDF/TPMS isosurface polygonizer, analytic CSG evaluator, LOD mesh optimizer, multi-format exporter (OBJ, STL, glTF 2.0, PLY, Three.js JSON, standalone WebGL HTML), local REST server, and 12-tool Model Context Protocol (MCP) server. Zero external Python runtime dependencies.
Version:
2.5.0Default Loopback Endpoint:
http://127.0.0.1:8082Zoth Studio v2 Dossier: https://zoth.nullai.tech/tools/nexus-3d-scene-studio
Author: 1nc0gn30 (
@1nc0gn30· https://1nc0gn30.si) & NullAI (https://nullai.tech)License: MIT (100% free and open-source)
Overview
Nexus 3D Scene Studio provides deterministic 3D mesh generation and topological analysis using only the Python standard library (src/nexus_3d_scene_studio/) paired with an interactive Three.js WebGL workstation (public/index.html):
Parametric & 4D Geometry (
geometry_engine.py): 4D stereographic hypercubes (tesseract),(p, q)torus knots, deformed superquadrics (pinch,taper,bend,twist), Platonic solids, C60 Fullerene buckyballs, Mobius strips, Fibonacci sphere lattices, and multi-octave heightmap terrains.Fractals & Attractors (
procedural_fractals.py): Lorenz, Rossler, Aizawa, and Chen strange-attractor tube ribbons, Klein bottles, Menger sponges, and multi-tier LOD decimation pyramids.Volumetric SDF & CSG Meshing (
sdf_isosurface.py): Watertight Marching Tetrahedra polygonization of Triply Periodic Minimal Surfaces (gyroid,schwarz_p,neovius), Mandelbulb fractals, metaballs, and smooth/hard CSG boolean primitives.Multi-Format Export & Budget Auditing (
mesh_exporter.py,scene_optimizer.py): Wavefront.obj+.mtl, ASCII.stl, ASCII.ply, embedded-buffer.gltf2.0, Three.jsBufferGeometryJSON, standalone OrbitControls WebGL.html, complete.zipasset bundles, and polygon/VRAM budget grading.
Related MCP server: openscad-mcp
Architecture
nexus-3d-scene-studio/
├── assets/hero-banner.svg # Studio vector banner
├── bin/nexus-3d.js # Unified CLI, web, and Electron launcher
├── docs/ # Math, export format, and MCP specifications
├── public/index.html # Interactive Three.js WebGL workstation
├── src/nexus_3d_scene_studio/
│ ├── geometry_engine.py # Parametric 3D/4D manifold generators
│ ├── procedural_fractals.py # Strange attractors, Klein bottle, Menger, & LOD
│ ├── sdf_isosurface.py # Marching Tetrahedra SDF, TPMS, & CSG booleans
│ ├── mesh_exporter.py # OBJ, MTL, STL, PLY, glTF 2.0, Three.js, & HTML
│ ├── scene_optimizer.py # Polygon budget, VRAM, & bounding-box auditor
│ ├── ui_server.py # ThreadingHTTPServer REST API & static host (:8082)
│ ├── mcp_server.py # JSON-RPC 2.0 stdio MCP server (2024-11-05, 12 tools)
│ └── cli.py # Subcommand CLI (nexus-3d / scene-studio)
└── tests/ # Pytest geometry, SDF, glTF/PLY, CLI, MCP, & HTTP suiteQuickstart
Clone the repository and install in editable mode:
git clone https://github.com/1nc0gn30/nexus-3d-scene-studio.git
cd nexus-3d-scene-studio
python3 -m pip install -e ".[dev]"Start the local WebGL workstation and REST API on 127.0.0.1:8082:
python3 server.py --port 8082
# or via the CLI / Node wrapper:
nexus-3d serve --host 127.0.0.1 --port 8082
node bin/nexus-3d.js webVerify service health:
curl -s http://127.0.0.1:8082/healthCLI & MCP Usage
CLI Subcommands
Both nexus-3d (scene-studio) and node bin/nexus-3d.js expose the full CLI surface:
# Help, version, and JSON status
nexus-3d --help
nexus-3d --version
nexus-3d --status --json
# Generate procedural meshes to OBJ, STL, glTF, PLY, Three.js JSON, or standalone HTML
nexus-3d generate torus_knot -p "p=3,q=5" -f obj -o knot.obj
nexus-3d generate tesseract -p '{"size":2.0,"angle_4d":0.6}' -f gltf -o hypercube.gltf
nexus-3d generate buckyball -f html --theme dark -o viewer.html
# Audit polygon budget, surface area, bounding box, and VRAM footprint
nexus-3d audit torus_knot -p "p=3,q=7" --json
nexus-3d audit knot.obj --json
# Inspect MCP tool definitions or emit client configuration JSON
nexus-3d mcp --tools
nexus-3d mcp --config claude
# Runtime and platform diagnostics
nexus-3d platform --jsonZothOS v3.4.0 Integration
On ZothOS v3.4.0 workstations, nexus-3d is installed on the system PATH and pairs with the Zoth Studio v2 dossier (https://zoth.nullai.tech/tools/nexus-3d-scene-studio) on loopback port 127.0.0.1:8082 with local-origin CORS protection (localhost, 127.0.0.1, ::1).
REST API Endpoints (127.0.0.1:8082)
Method | Path | Description |
|
| Service status, version, uptime, and platform summary |
|
| Default procedural shape presets and parameter schemas |
|
| Available volumetric SDF and TPMS presets |
|
| Generate MCP client snippet ( |
|
| Detailed system and Python runtime diagnostics |
|
| Generate a procedural mesh with Three.js JSON and budget audit |
|
| Polygonize a volumetric SDF/TPMS preset via Marching Tetrahedra |
|
| Export mesh to |
|
| Audit raw mesh data or a named procedural shape |
|
| Build a complete ZIP bundle ( |
MCP Server (stdio)
Start the JSON-RPC 2.0 MCP server (protocolVersion: 2024-11-05):
nexus-3d mcpRegistered MCP tools (12) — see docs/MCP_GUIDE.md for schemas:
nexus_generate_tesseract,nexus_generate_torus_knot,nexus_generate_superquadric,nexus_generate_solid,nexus_generate_terrainnexus_generate_fractal,nexus_generate_lod_pyramid,nexus_generate_sdf_isosurface,nexus_evaluate_csg_booleannexus_export_mesh,nexus_audit_mesh,nexus_get_diagnostics
Testing & Verification
Run the full test suite and secret scan locally:
python3 -m pytest -q
node bin/nexus-3d.js --status --json
gitleaks detect --source . --no-banner --redactSupport
Nexus 3D Scene Studio is 100% free and open-source with zero paywalls:
Buy Us a Coffee (Stripe): https://buy.stripe.com/3cIfZg27PdKo2D64Ocfw40X
Solana Tip Address:
GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK(solana:GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK)
License
Released under the MIT License. Engineered by Neal Frazier Tech (@1nc0gn30 • https://github.com/1nc0gn30/nexus-3d-scene-studio) • NullAI Platform (https://nullai.tech).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
OCR, transcription, file extraction, and image generation for AI agents via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceExposes 50+ Blender tools (object manipulation, materials, animation, etc.) via MCP for AI-driven 3D workflows and automation.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to create and manipulate 3D models using OpenSCAD through MCP tools for code-based modeling, preview, and export.1MIT
- AlicenseAqualityCmaintenanceEnables instruction-driven editing of 3D indoor scene meshes, including object segmentation, geometric edits, rendering, and full plan/verify agent loops, through MCP tools.13MIT
- AlicenseAqualityCmaintenanceEnables AI agents and MCP clients to perform 3D asset creation and verification: exact b-rep CAD, GLB validation with embedded certificates, mesh inspection, and physics scenes, with most tools running without Blender.3648 npmMIT