@babylonjs/mcp-servers 9.11.0

package/package.json

@@ -0,0 +1,48 @@
+{
+    "name": "@babylonjs/mcp-servers",
+    "version": "9.11.0",
+    "description": "Bundled Model Context Protocol servers for Babylon.js authoring workflows",
+    "type": "module",
+    "bin": {
+        "mcp-servers": "dist/babylonjs-mcp-servers.js",
+        "babylonjs-mcp-servers": "dist/babylonjs-mcp-servers.js",
+        "babylonjs-flow-graph-mcp-server": "dist/flow-graph-mcp-server.js",
+        "babylonjs-gui-mcp-server": "dist/gui-mcp-server.js",
+        "babylonjs-nge-mcp-server": "dist/nge-mcp-server.js",
+        "babylonjs-nme-mcp-server": "dist/nme-mcp-server.js",
+        "babylonjs-npe-mcp-server": "dist/npe-mcp-server.js",
+        "babylonjs-nrge-mcp-server": "dist/nrge-mcp-server.js",
+        "babylonjs-smart-filters-mcp-server": "dist/smart-filters-mcp-server.js"
+    },
+    "files": [
+        "dist/**/*.*",
+        "readme.md"
+    ],
+    "scripts": {
+        "build": "npm run clean && npm run build:servers && npm run copy:servers",
+        "build:servers": "npm run build -w @tools/mcp-server-core && npm run build -w @tools/nme-mcp-server && npm run build -w @tools/npe-mcp-server && npm run build -w @tools/nge-mcp-server && npm run build -w @tools/nrge-mcp-server && npm run build -w @tools/gui-mcp-server && npm run build -w @tools/flow-graph-mcp-server && npm run build -w @tools/smart-filters-mcp-server",
+        "clean": "rimraf dist",
+        "copy:servers": "node scripts/copyMcpServers.mjs"
+    },
+    "engines": {
+        "node": "^20.19.0 || >=22.13.0 <23.0.0"
+    },
+    "keywords": [
+        "3D",
+        "javascript",
+        "html5",
+        "webgl",
+        "babylon.js",
+        "mcp",
+        "model-context-protocol"
+    ],
+    "license": "Apache-2.0",
+    "homepage": "https://www.babylonjs.com",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/BabylonJS/Babylon.js.git"
+    },
+    "bugs": {
+        "url": "https://github.com/BabylonJS/Babylon.js/issues"
+    }
+}

package/readme.md

@@ -0,0 +1,73 @@
+# Babylon.js MCP Servers
+
+`@babylonjs/mcp-servers` packages the Babylon.js Model Context Protocol servers as executable Node.js binaries. MCP-compatible clients can use these servers to create, edit, validate, import, export, and live-sync Babylon.js authoring graphs.
+
+## Included Servers
+
+| Server                   | Dispatcher name | Direct binary                        | Purpose                                                                  |
+| ------------------------ | --------------- | ------------------------------------ | ------------------------------------------------------------------------ |
+| Node Material Editor     | `nme`           | `babylonjs-nme-mcp-server`           | Node Material graph authoring and import/export workflows.               |
+| Node Geometry Editor     | `nge`           | `babylonjs-nge-mcp-server`           | Node Geometry graph authoring and export/import workflows.               |
+| Node Render Graph Editor | `nrge`          | `babylonjs-nrge-mcp-server`          | Node Render Graph authoring and render-pipeline export/import workflows. |
+| Node Particle Editor     | `npe`           | `babylonjs-npe-mcp-server`           | Node Particle graph authoring and export/import workflows.               |
+| GUI Editor               | `gui`           | `babylonjs-gui-mcp-server`           | Babylon.js GUI authoring, layout, export/import, and snippet flows.      |
+| Flow Graph Editor        | `flow-graph`    | `babylonjs-flow-graph-mcp-server`    | Flow Graph authoring and coordinator JSON export/import workflows.       |
+| Smart Filters Editor     | `smart-filters` | `babylonjs-smart-filters-mcp-server` | Smart Filters graph authoring and export/import workflows.               |
+
+## Run With npx
+
+Use the dispatcher when you want a compact command:
+
+```sh
+npx -y @babylonjs/mcp-servers nme
+```
+
+Use direct binaries when your MCP client expects a command name:
+
+```sh
+npx -y -p @babylonjs/mcp-servers babylonjs-nme-mcp-server
+```
+
+## MCP Client Configuration
+
+Most MCP clients accept a command plus arguments. This example starts the Node Material Editor MCP server through the dispatcher:
+
+```json
+{
+    "mcpServers": {
+        "babylonjs-node-material": {
+            "command": "npx",
+            "args": ["-y", "@babylonjs/mcp-servers", "nme"]
+        }
+    }
+}
+```
+
+This equivalent form uses the direct binary:
+
+```json
+{
+    "mcpServers": {
+        "babylonjs-node-material": {
+            "command": "npx",
+            "args": ["-y", "-p", "@babylonjs/mcp-servers", "babylonjs-nme-mcp-server"]
+        }
+    }
+}
+```
+
+## Live Editor Sessions
+
+The graph MCP servers can start a local editor session server and return a session URL. Paste that URL into the matching Babylon.js editor's MCP session panel to see live updates from the MCP server and to push editor changes back to the MCP server.
+
+The local editor session server binds to `127.0.0.1` by default. It stops when the MCP process exits, when the `stop_session_server` MCP tool is called, or after 15 minutes without MCP/editor activity.
+
+## Local Development
+
+From the Babylon.js repository, build the package with:
+
+```sh
+npm run build -w @babylonjs/mcp-servers
+```
+
+The build compiles the private MCP server workspaces and copies their bundled `dist/index.js` outputs into this package's `dist/` directory.