sceneview-mcp 3.4.13 → 3.4.14

package/README.md

@@ -72,7 +72,7 @@ Same JSON config as above. The server communicates via **stdio** using the stand
 
 ## What you get
 
-### 14 tools
+### 18 tools
 
 | Tool | What it does |
 |---|---|
@@ -91,6 +91,10 @@ Same JSON config as above. The server communicates via **stdio** using the stand
 | `get_platform_roadmap` | Multi-platform status and timeline (Android, iOS, KMP, Web, Desktop) |
 | `render_3d_preview` | Generates an interactive 3D preview link the user can open in their browser |
 | `create_3d_artifact` | Generates self-contained HTML artifacts (model viewer, 3D charts, product 360) |
+| `get_platform_setup` | Unified setup guide for any platform (Android, iOS, Web, Flutter, React Native, Desktop, TV) |
+| `migrate_code` | Automatically migrates SceneView 2.x code to 3.x with detailed changelog |
+| `debug_issue` | Targeted debugging guide by category or auto-detected from problem description |
+| `generate_scene` | Generates a complete composable from natural language (e.g., "a room with a table and two chairs") |
 
 ### 2 resources
 
@@ -218,7 +222,7 @@ npm run dev      # Start with tsx (hot reload)
 ```
 mcp/
   src/
-    index.ts          # MCP server entry point (14 tools, 2 resources)
+    index.ts          # MCP server entry point (18 tools, 2 resources)
     samples.ts         # 33 compilable code samples (Kotlin + Swift)
     validator.ts       # Code validator (15+ rules, Kotlin + Swift)
     node-reference.ts  # Node type parser (extracts from llms.txt)

package/dist/generate-scene.js

@@ -23,7 +23,41 @@ const OBJECT_MAPPINGS = [
     { keywords: ["car", "vehicle"], nodeType: "ModelNode", defaultScale: 2.0, defaultPosition: [0, 0, 0], comment: "Car (use GLB model)" },
     { keywords: ["house", "building"], nodeType: "ModelNode", defaultScale: 5.0, defaultPosition: [0, 0, -5], comment: "Building (use GLB model)" },
     // People / characters
-    { keywords: ["person", "character", "human", "avatar", "robot"], nodeType: "ModelNode", defaultScale: 1.7, defaultPosition: [0, 0, 0], comment: "Character (use GLB model)" },
+    { keywords: ["person", "character", "human", "avatar"], nodeType: "ModelNode", defaultScale: 1.7, defaultPosition: [0, 0, 0], comment: "Character (use GLB model)" },
+    { keywords: ["robot", "android"], nodeType: "ModelNode", defaultScale: 1.5, defaultPosition: [0, 0, 0], comment: "Robot (use GLB model)" },
+    // Animals
+    { keywords: ["dog", "puppy"], nodeType: "ModelNode", defaultScale: 0.6, defaultPosition: [1, 0, 0], comment: "Dog (use GLB model)" },
+    { keywords: ["cat", "kitten"], nodeType: "ModelNode", defaultScale: 0.4, defaultPosition: [-1, 0, 0], comment: "Cat (use GLB model)" },
+    { keywords: ["bird"], nodeType: "ModelNode", defaultScale: 0.2, defaultPosition: [0, 2, 0], comment: "Bird (use GLB model)" },
+    { keywords: ["horse"], nodeType: "ModelNode", defaultScale: 2.5, defaultPosition: [0, 0, 2], comment: "Horse (use GLB model)" },
+    { keywords: ["fish"], nodeType: "ModelNode", defaultScale: 0.3, defaultPosition: [0, 0.5, 0], comment: "Fish (use GLB model)" },
+    { keywords: ["dinosaur", "dino", "t-rex"], nodeType: "ModelNode", defaultScale: 5.0, defaultPosition: [0, 0, -3], comment: "Dinosaur (use GLB model)" },
+    { keywords: ["dragon"], nodeType: "ModelNode", defaultScale: 4.0, defaultPosition: [0, 2, -3], comment: "Dragon (use GLB model)" },
+    // More vehicles
+    { keywords: ["airplane", "plane", "jet"], nodeType: "ModelNode", defaultScale: 5.0, defaultPosition: [0, 5, 0], comment: "Airplane (use GLB model)" },
+    { keywords: ["boat", "ship"], nodeType: "ModelNode", defaultScale: 4.0, defaultPosition: [0, 0, -3], comment: "Boat (use GLB model)" },
+    { keywords: ["bicycle", "bike"], nodeType: "ModelNode", defaultScale: 1.2, defaultPosition: [2, 0, 0], comment: "Bicycle (use GLB model)" },
+    { keywords: ["motorcycle", "motorbike"], nodeType: "ModelNode", defaultScale: 1.5, defaultPosition: [2, 0, 0], comment: "Motorcycle (use GLB model)" },
+    { keywords: ["truck"], nodeType: "ModelNode", defaultScale: 3.0, defaultPosition: [0, 0, -2], comment: "Truck (use GLB model)" },
+    // More environment
+    { keywords: ["flower", "rose"], nodeType: "ModelNode", defaultScale: 0.3, defaultPosition: [1, 0, 1], comment: "Flower (use GLB model)" },
+    { keywords: ["rock", "stone", "boulder"], nodeType: "SphereNode", geometryType: "sphere", defaultScale: 0.8, defaultPosition: [1, 0.4, 1], comment: "Rock" },
+    { keywords: ["mountain", "hill"], nodeType: "ModelNode", defaultScale: 10.0, defaultPosition: [0, 0, -10], comment: "Mountain (use GLB model)" },
+    { keywords: ["fence"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 2.0, defaultPosition: [3, 0.5, 0], comment: "Fence" },
+    { keywords: ["bridge"], nodeType: "ModelNode", defaultScale: 5.0, defaultPosition: [0, 0, 0], comment: "Bridge (use GLB model)" },
+    // More furniture / objects
+    { keywords: ["lamp", "light fixture"], nodeType: "ModelNode", defaultScale: 0.5, defaultPosition: [1, 0.8, 0], comment: "Lamp (use GLB model)" },
+    { keywords: ["tv", "television", "screen", "monitor"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 1.2, defaultPosition: [0, 0.8, -2], comment: "TV/Screen (flat cube)" },
+    { keywords: ["door", "gate"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 2.0, defaultPosition: [0, 1, -3], comment: "Door" },
+    { keywords: ["window"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 1.0, defaultPosition: [2, 1.5, -3], comment: "Window" },
+    { keywords: ["stairs", "staircase"], nodeType: "ModelNode", defaultScale: 2.0, defaultPosition: [3, 0, 0], comment: "Stairs (use GLB model)" },
+    { keywords: ["book", "books"], nodeType: "CubeNode", geometryType: "cube", defaultScale: 0.2, defaultPosition: [0, 0.5, 0], comment: "Book" },
+    { keywords: ["bottle", "vase"], nodeType: "CylinderNode", geometryType: "cylinder", defaultScale: 0.2, defaultPosition: [0, 0.3, 0], comment: "Bottle/Vase" },
+    { keywords: ["trophy", "cup"], nodeType: "ModelNode", defaultScale: 0.3, defaultPosition: [0, 0.5, 0], comment: "Trophy (use GLB model)" },
+    // Food
+    { keywords: ["pizza"], nodeType: "CylinderNode", geometryType: "cylinder", defaultScale: 0.3, defaultPosition: [0, 0.5, 0], comment: "Pizza (flat cylinder)" },
+    { keywords: ["cake"], nodeType: "CylinderNode", geometryType: "cylinder", defaultScale: 0.3, defaultPosition: [0, 0.5, 0], comment: "Cake (cylinder)" },
+    { keywords: ["apple", "fruit"], nodeType: "SphereNode", geometryType: "sphere", defaultScale: 0.08, defaultPosition: [0, 0.5, 0], comment: "Apple/Fruit" },
 ];
 const LIGHT_KEYWORDS = ["sun", "sunlight", "daylight", "bright", "lit", "sunny", "well-lit"];
 const INDOOR_KEYWORDS = ["room", "indoor", "inside", "interior"];

package/dist/index.js

@@ -37,7 +37,7 @@ catch {
     API_DOCS = "SceneView API docs not found. Run `npm run prepare` to bundle llms.txt.";
 }
 const NODE_SECTIONS = parseNodeSections(API_DOCS);
-const server = new Server({ name: "@sceneview/mcp", version: "3.4.13" }, { capabilities: { resources: {}, tools: {} } });
+const server = new Server({ name: "@sceneview/mcp", version: "3.4.14" }, { capabilities: { resources: {}, tools: {} } });
 // ─── Resources ───────────────────────────────────────────────────────────────
 server.setRequestHandler(ListResourcesRequestSchema, async () => ({
     resources: [
@@ -403,18 +403,27 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         {
             name: "generate_scene",
-            description: 'Generates a complete, compilable Scene{} or ARScene{} Kotlin composable from a natural language description. Parses objects (table, chair, sphere, car, etc.), quantities ("two chairs", "3 spheres"), environment (indoor/outdoor/dark), and mode (3D or AR). Returns working Kotlin code with proper engine setup, model loading, lighting, and ground plane. Use this when a user says "build me a scene with..." or describes a 3D scene they want to create.',
+            description: 'Generates a complete, compilable Scene{} or ARScene{} Kotlin composable from a natural language description. Parses 40+ object types (furniture, vehicles, animals, food, buildings, nature), quantities ("two chairs", "3 spheres"), environment (indoor/outdoor/dark), and mode (3D or AR). Returns working Kotlin code with proper engine setup, model loading, lighting, and ground plane. Use this when a user says "build me a scene with..." or describes a 3D scene they want to create.',
             inputSchema: {
                 type: "object",
                 properties: {
                     description: {
                         type: "string",
-                        description: 'Natural language description of the desired 3D scene. Examples: "a room with a table and two chairs", "AR scene with a robot on the floor", "outdoor scene with three trees and a car", "dark room with a sphere and a cube".',
+                        description: 'Natural language description of the desired 3D scene. Examples: "a room with a table and two chairs", "AR scene with a robot on the floor", "outdoor scene with three trees and a car", "dark room with a sphere and a cube", "a dog and a cat in a garden", "house with a fence and flowers".',
                     },
                 },
                 required: ["description"],
             },
         },
+        {
+            name: "list_platforms",
+            description: "Returns all platforms supported by SceneView with their renderer, framework, status, and version. Use this to answer questions about what platforms SceneView supports, or to show cross-platform capabilities.",
+            inputSchema: {
+                type: "object",
+                properties: {},
+                required: [],
+            },
+        },
     ],
 }));
 // ─── Tool handlers ────────────────────────────────────────────────────────────
@@ -1006,6 +1015,41 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             const sceneReport = formatGeneratedScene(sceneResult);
             return { content: withDisclaimer([{ type: "text", text: sceneReport }]) };
         }
+        // ── list_platforms ────────────────────────────────────────────────────────
+        case "list_platforms": {
+            const platforms = [
+                { platform: "Android", renderer: "Filament", framework: "Jetpack Compose", status: "Stable", version: "3.3.0", dependency: "io.github.sceneview:sceneview:3.3.0", features: ["3D", "AR (ARCore)", "Model loading (GLB/glTF)", "Geometry nodes", "Physics", "Gestures"] },
+                { platform: "Android TV", renderer: "Filament", framework: "Compose TV", status: "Alpha", version: "3.3.0", dependency: "io.github.sceneview:sceneview:3.3.0", features: ["3D", "D-pad controls", "Auto-rotation", "Model loading"] },
+                { platform: "Android XR", renderer: "Jetpack XR SceneCore", framework: "Compose XR", status: "Planned", version: "-", dependency: "-", features: ["Spatial computing", "Hand tracking", "Passthrough"] },
+                { platform: "iOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.3.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "AR (ARKit)", "16 node types", "USDZ models"] },
+                { platform: "macOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.3.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Orbit camera", "USDZ models"] },
+                { platform: "visionOS", renderer: "RealityKit", framework: "SwiftUI", status: "Alpha", version: "3.3.0", dependency: "SceneViewSwift (SPM)", features: ["3D", "Immersive spaces", "Hand tracking (planned)"] },
+                { platform: "Web", renderer: "Filament.js (WASM)", framework: "Kotlin/JS", status: "Alpha", version: "3.3.0", dependency: "@sceneview/sceneview-web", features: ["3D", "WebXR AR/VR", "GLB models", "WebGL2"] },
+                { platform: "Desktop", renderer: "Software / Filament JNI", framework: "Compose Desktop", status: "Alpha", version: "3.3.0", dependency: "sceneview-desktop (local)", features: ["3D", "Software renderer", "Wireframe"] },
+                { platform: "Flutter", renderer: "Filament / RealityKit", framework: "PlatformView", status: "Alpha", version: "3.3.0", dependency: "flutter pub: sceneview", features: ["3D", "AR", "Android + iOS bridge"] },
+            ];
+            const lines = [
+                "## SceneView Supported Platforms\n",
+                "| Platform | Renderer | Framework | Status | Version |",
+                "|----------|----------|-----------|--------|---------|",
+                ...platforms.map(p => `| ${p.platform} | ${p.renderer} | ${p.framework} | ${p.status} | ${p.version} |`),
+                "",
+                "### Platform Details\n",
+                ...platforms.map(p => [
+                    `**${p.platform}** (${p.status})`,
+                    `- Renderer: ${p.renderer}`,
+                    `- Framework: ${p.framework}`,
+                    `- Dependency: \`${p.dependency}\``,
+                    `- Features: ${p.features.join(", ")}`,
+                    "",
+                ].join("\n")),
+                "### Architecture",
+                "",
+                "SceneView uses **native renderers per platform**: Filament on Android/Web/Desktop, RealityKit on Apple (iOS/macOS/visionOS).",
+                "KMP `sceneview-core` shares logic (math, collision, geometry, animations) across all platforms.",
+            ];
+            return { content: withDisclaimer([{ type: "text", text: lines.join("\n") }]) };
+        }
         default:
             return {
                 content: [{ type: "text", text: `Unknown tool: ${request.params.name}` }],

package/llms.txt

@@ -2357,6 +2357,52 @@ model.enableManipulation()  // look + grab + drag + rotate + scale via system ge
 
 ---
 
+## MCP Server Tools
+
+The `@sceneview/mcp` server (npm: `sceneview-mcp`) exposes 18 tools and 2 resources for AI assistants.
+
+### Setup tools
+| Tool | Parameters | Description |
+|---|---|---|
+| `get_setup` | `type: "3d" \| "ar"` | Gradle + manifest setup for Android 3D or AR projects |
+| `get_ios_setup` | `type: "3d" \| "ar"` | SPM dependency, Info.plist, and SwiftUI integration for iOS/macOS/visionOS |
+| `get_web_setup` | _(none)_ | Kotlin/JS + Filament.js (WASM) setup for browser-based 3D |
+| `get_ar_setup` | _(none)_ | Detailed AR config: permissions, session options, plane detection, image tracking |
+| `get_platform_setup` | `platform: "android" \| "ios" \| "web" \| "flutter" \| "react-native" \| "desktop" \| "tv"`, `type: "3d" \| "ar"` | Unified setup guide for any platform. Replaces `get_setup`, `get_ios_setup`, `get_web_setup` with a single tool |
+
+### Code tools
+| Tool | Parameters | Description |
+|---|---|---|
+| `get_sample` | `scenario: string` | Returns a complete, compilable code sample for any of 33 scenarios (Kotlin or Swift) |
+| `list_samples` | `tag?: string` | Browse all samples, filter by tag (`ar`, `3d`, `ios`, `animation`, `geometry`, ...) |
+| `validate_code` | `code: string`, `language?: "kotlin" \| "swift"` | Checks generated code against 15+ rules before presenting it to the user |
+| `migrate_code` | `code: string` | Automatically migrates SceneView 2.x Kotlin code to 3.x. Applies known renames, replaces deprecated APIs, fixes LightNode trailing-lambda bug, removes Sceneform imports. Returns migrated code with a detailed changelog |
+| `generate_scene` | `description: string` | Generates a complete, compilable `Scene{}` or `ARScene{}` Kotlin composable from a natural language description. Parses objects, quantities, environment, and mode |
+
+### Reference tools
+| Tool | Parameters | Description |
+|---|---|---|
+| `get_node_reference` | `nodeType: string` | Full API reference for any of 26+ node types -- exact signatures, defaults, examples |
+| `get_migration_guide` | _(none)_ | Every breaking change from SceneView 2.x to 3.0 with before/after code |
+| `get_platform_roadmap` | _(none)_ | Multi-platform status and timeline (Android, iOS, KMP, Web, Desktop) |
+| `get_best_practices` | `topic?: string` | Performance, architecture, memory, and threading guidance |
+| `get_troubleshooting` | _(none)_ | Common crashes, build failures, AR issues, and their fixes |
+| `debug_issue` | `category?: "model-not-showing" \| "ar-not-working" \| "crash" \| "performance" \| "build-error" \| "black-screen" \| "lighting" \| "gestures" \| "ios"`, `description?: string` | Targeted debugging guide for a specific issue. Provide a category or describe the problem for auto-detection |
+
+### Preview tools
+| Tool | Parameters | Description |
+|---|---|---|
+| `render_3d_preview` | `model: string`, `env?: string`, `bg?: string` | Generates an interactive 3D preview link the user can open in their browser |
+| `create_3d_artifact` | `type: "model-viewer" \| "chart-3d" \| "product-360" \| "scene-builder" \| "ar-preview"`, ... | Generates self-contained HTML artifacts |
+
+### Resources
+| URI | Description |
+|---|---|
+| `sceneview://api` | Complete SceneView API reference (the full `llms.txt`) |
+| `sceneview://known-issues` | Live open issues from GitHub (cached 10 min) |
+
+---
+
 ## Platform Coverage Summary
 
 | Platform | Renderer | Framework | Sample | Status |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sceneview-mcp",
-  "version": "3.4.13",
+  "version": "3.4.14",
   "mcpName": "io.github.sceneview/mcp",
   "description": "MCP server for SceneView — cross-platform 3D & AR SDK for Android and iOS. Give Claude the full SceneView SDK so it writes correct, compilable code.",
   "keywords": [