sceneview-mcp 3.0.0 → 3.0.1

package/README.md

@@ -1,36 +1,17 @@
 # sceneview-mcp
 
-MCP server for [SceneView](https://github.com/SceneView/sceneview-android) — 3D and AR with Jetpack Compose for Android.
+[![npm](https://img.shields.io/npm/v/sceneview-mcp?color=cb3837&label=npm)](https://www.npmjs.com/package/sceneview-mcp)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-Install this once and Claude always knows how to use SceneView. No copy-pasting docs. No hallucinated APIs.
+MCP server for [SceneView](https://github.com/SceneView/sceneview-android) — 3D and AR as Jetpack Compose composables for Android.
 
----
-
-## What it provides
-
-**Resource — `sceneview://api`**
-The complete SceneView 3.0.0 API reference (llms.txt): composable signatures, node types, AR scope, resource loading, threading rules, common patterns.
-
-**Tool — `get_sample`**
-
-| Scenario | What you get |
-|---|---|
-| `model-viewer` | Full-screen 3D scene, HDR environment, orbit camera |
-| `ar-tap-to-place` | AR tap-to-place with pinch-to-scale and drag-to-rotate |
-| `ar-placement-cursor` | AR reticle that snaps to surfaces, tap to confirm |
-| `ar-augmented-image` | Detect a reference image, overlay a 3D model |
-| `ar-face-filter` | Front-camera face mesh with a custom material |
-
-**Tool — `get_setup`**
-Gradle dependency + AndroidManifest for `"3d"` or `"ar"` projects.
+Add this to Claude and it **always knows how to use SceneView**. No copy-pasting docs. No hallucinated APIs. Correct, compilable Kotlin — first try.
 
 ---
 
-## Installation
+## Quick start
 
-### Project-level (recommended)
-
-Add `.claude/mcp.json` at your Android project root:
+Add to your Claude config and you're done:
 
 ```json
 {
@@ -43,112 +24,80 @@ Add `.claude/mcp.json` at your Android project root:
 }
 ```
 
-Run `/mcp` in Claude Code to confirm the server is connected.
+<details>
+<summary>Where does this go?</summary>
 
-### Global (all projects)
+| Client | Config file |
+|---|---|
+| **Claude Code** (project) | `.claude/mcp.json` at project root |
+| **Claude Code** (global) | `~/.claude/mcp.json` |
+| **Claude Desktop** | `claude_desktop_config.json` |
 
-Add to `~/.claude/mcp.json`:
+After saving, run `/mcp` in Claude Code or restart Claude Desktop to pick it up.
+</details>
 
-```json
-{
-  "mcpServers": {
-    "sceneview": {
-      "command": "npx",
-      "args": ["-y", "sceneview-mcp"]
-    }
-  }
-}
-```
+---
 
-### Claude Desktop
+## What Claude gets
 
-Add to `claude_desktop_config.json`:
+### Resource — `sceneview://api`
 
-```json
-{
-  "mcpServers": {
-    "sceneview": {
-      "command": "npx",
-      "args": ["-y", "sceneview-mcp"]
-    }
-  }
-}
-```
+The complete SceneView 3.0.0 API reference (`llms.txt`): composable signatures, node types, AR scope, resource loading, threading rules, and common patterns.
+
+### Tool — `get_sample(scenario)`
+
+Returns a complete, compilable Kotlin sample.
+
+| Scenario | What you get |
+|---|---|
+| `model-viewer` | Full-screen 3D scene, HDR environment, orbit camera |
+| `ar-tap-to-place` | AR tap-to-place with pinch-to-scale and drag-to-rotate |
+| `ar-placement-cursor` | AR reticle that snaps to surfaces, tap to confirm |
+| `ar-augmented-image` | Detect a reference image, overlay a 3D model |
+| `ar-face-filter` | Front-camera face mesh with a custom material |
+
+### Tool — `get_setup(type)`
+
+Returns Gradle dependencies + AndroidManifest for `"3d"` or `"ar"` projects.
 
 ---
 
 ## How it works
 
 ```
-Developer: "add AR placement to my app"
+You:    "Add AR placement to my app"
          │
-         ▼
-Claude reads sceneview://api  ←  full llms.txt, always current
+Claude:  reads sceneview://api  ←  full API ref, always current
          │
-         ▼
-Claude calls get_sample("ar-tap-to-place")  ←  working Kotlin boilerplate
+Claude:  calls get_sample("ar-tap-to-place")  ←  working Kotlin
          │
-         ▼
-Correct, compilable SceneView 3.0.0 code — first try, zero hallucination
+Result:  Correct, compilable SceneView 3.0.0 code
 ```
 
 ---
 
-## Sample prompts
+## Try it — sample prompts
 
-### 3D model viewer
-```
-Create an Android Compose screen called ModelViewerScreen that loads
-assets/models/my_model.glb in a full-screen 3D scene with orbit camera and HDR
-environment from assets/environments/sky_2k.hdr.
-Use SceneView io.github.sceneview:sceneview:3.0.0.
-```
+**3D model viewer**
+> Create a Compose screen that loads `models/helmet.glb` in a full-screen 3D scene with orbit camera and HDR environment. Use SceneView 3.0.0.
 
-### AR tap-to-place
-```
-Create an Android Compose AR screen called TapToPlaceScreen. Show a plane
-detection grid. Tapping places assets/models/chair.glb on the surface with
-pinch-to-scale and drag-to-rotate. Multiple taps = multiple objects.
-Use SceneView io.github.sceneview:arsceneview:3.0.0.
-```
+**AR tap-to-place**
+> Create an AR Compose screen. Tapping a detected surface places `models/chair.glb` with pinch-to-scale and drag-to-rotate. Multiple taps = multiple objects.
 
-### AR placement cursor
-```
-Create an AR screen called ARCursorScreen with a reticle that snaps to surfaces
-at screen center. Tap to place assets/models/object.glb and hide the reticle.
-Use SceneView io.github.sceneview:arsceneview:3.0.0.
-```
+**AR placement cursor**
+> Create an AR screen with a reticle that snaps to surfaces at screen center. Tap to place `models/object.glb` and hide the reticle.
 
-### AR augmented image
-```
-Create an AR screen called AugmentedImageScreen that detects R.drawable.target_image
-(15 cm wide) and places assets/models/overlay.glb above it scaled to image width.
-Model disappears when tracking is lost.
-Use SceneView io.github.sceneview:arsceneview:3.0.0.
-```
+**AR augmented image**
+> Create an AR screen that detects `R.drawable.target_image` (15 cm) and places `models/overlay.glb` above it, scaled to match.
 
-### AR face filter
-```
-Create an AR screen called FaceFilterScreen using the front camera that detects
-faces and applies assets/materials/face_mask.filamat to the face mesh.
-Use SceneView io.github.sceneview:arsceneview:3.0.0.
-```
+**AR face filter**
+> Create an AR screen using the front camera that detects faces and applies `materials/face_mask.filamat` to the mesh.
 
-### 3D product configurator
-```
-Create a 3D product configurator screen with Red/Blue/Green color buttons.
-Apply the selected color as a solid material on assets/models/product.glb.
-Add orbit camera and pinch-to-zoom.
-Use SceneView io.github.sceneview:sceneview:3.0.0.
-```
+**Product configurator**
+> Create a 3D product configurator with Red/Blue/Green buttons. Apply the color as a material on `models/product.glb`. Add orbit camera and pinch-to-zoom.
 
-### AR multi-object scene
-```
-Create an AR screen where a bottom sheet lets users choose between chair, table,
-and lamp GLBs in assets/models/. Tapping places the selected model. Each object
-is independently pinch-to-scale and drag-to-rotate. A "Clear all" button removes
-everything. Use SceneView io.github.sceneview:arsceneview:3.0.0.
-```
+**AR multi-object scene**
+> Create an AR screen where a bottom sheet lets users pick between chair, table, and lamp GLBs. Tap to place. Each object gets pinch-to-scale and drag-to-rotate.
 
 ---
 
@@ -157,9 +106,9 @@ everything. Use SceneView io.github.sceneview:arsceneview:3.0.0.
 ```bash
 cd mcp
 npm install
-npm run prepare   # copies ../llms.txt and compiles TypeScript
+npm run prepare   # copies llms.txt + compiles TypeScript
 npm start         # run over stdio
-npx @modelcontextprotocol/inspector node dist/index.js  # test with inspector
+npx @modelcontextprotocol/inspector node dist/index.js   # test in MCP inspector
 ```
 
 ## Publishing
@@ -169,3 +118,11 @@ cd mcp
 npm run prepare
 npm publish --access public
 ```
+
+---
+
+## Links
+
+- **SDK**: [github.com/SceneView/sceneview-android](https://github.com/SceneView/sceneview-android)
+- **npm**: [npmjs.com/package/sceneview-mcp](https://www.npmjs.com/package/sceneview-mcp)
+- **MCP spec**: [modelcontextprotocol.io](https://modelcontextprotocol.io)

package/dist/index.js

@@ -14,7 +14,7 @@ try {
 catch {
     API_DOCS = "SceneView API docs not found. Run `npm run prepare` to bundle llms.txt.";
 }
-const server = new Server({ name: "@sceneview/mcp", version: "3.0.0" }, { capabilities: { resources: {}, tools: {} } });
+const server = new Server({ name: "@sceneview/mcp", version: "3.0.1" }, { capabilities: { resources: {}, tools: {} } });
 server.setRequestHandler(ListResourcesRequestSchema, async () => ({
     resources: [
         {

package/dist/samples.js

@@ -30,6 +30,61 @@ fun ModelViewerScreen() {
             )
         }
     }
+}`,
+    },
+    "geometry-scene": {
+        id: "geometry-scene",
+        title: "3D Geometry Scene",
+        description: "Procedural 3D scene using primitive geometry nodes (cube, sphere, plane) — no GLB required",
+        dependency: "io.github.sceneview:sceneview:3.0.0",
+        prompt: "Create an Android Compose screen called `GeometrySceneScreen` that renders a full-screen 3D scene with a red rotating cube, a metallic blue sphere, and a green floor plane. No model files — use SceneView built-in geometry nodes. Orbit camera. Use SceneView `io.github.sceneview:sceneview:3.0.0`.",
+        code: `@Composable
+fun GeometrySceneScreen() {
+    val engine = rememberEngine()
+    val materialLoader = rememberMaterialLoader(engine)
+    val t = rememberInfiniteTransition(label = "spin")
+    val angle by t.animateFloat(
+        initialValue = 0f, targetValue = 360f,
+        animationSpec = infiniteRepeatable(tween(4_000, easing = LinearEasing)),
+        label = "angle"
+    )
+
+    Scene(
+        modifier = Modifier.fillMaxSize(),
+        engine = engine,
+        materialLoader = materialLoader,
+        mainLightNode = rememberMainLightNode(engine) { intensity(80_000f) },
+        cameraManipulator = rememberCameraManipulator()
+    ) {
+        // Rotating red cube
+        CubeNode(
+            engine,
+            size = Size(0.5f, 0.5f, 0.5f),
+            materialInstance = materialLoader.createColorInstance(
+                Color.Red, metallic = 0f, roughness = 0.5f
+            ),
+            position = Position(x = -0.6f),
+            rotation = Rotation(y = angle)
+        )
+        // Metallic blue sphere
+        SphereNode(
+            engine,
+            radius = 0.3f,
+            materialInstance = materialLoader.createColorInstance(
+                Color.Blue, metallic = 0.8f, roughness = 0.2f
+            ),
+            position = Position(x = 0.6f)
+        )
+        // Floor plane
+        PlaneNode(
+            engine,
+            size = Size(2f, 0f, 2f),
+            materialInstance = materialLoader.createColorInstance(
+                Color(0xFF4CAF50), metallic = 0f, roughness = 0.9f
+            ),
+            position = Position(y = -0.35f)
+        )
+    }
 }`,
     },
     "ar-tap-to-place": {

package/package.json

@@ -1,9 +1,31 @@
 {
   "name": "sceneview-mcp",
-  "version": "3.0.0",
-  "description": "MCP server for SceneView — 3D and AR with Jetpack Compose for Android",
-  "keywords": ["mcp", "sceneview", "android", "ar", "3d", "compose", "filament", "arcore"],
+  "version": "3.0.1",
+  "description": "MCP server for SceneView — 3D and AR with Jetpack Compose for Android. Give Claude the full SceneView SDK so it writes correct, compilable Kotlin.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "sceneview",
+    "android",
+    "ar",
+    "arcore",
+    "3d",
+    "filament",
+    "jetpack-compose",
+    "claude",
+    "ai"
+  ],
   "license": "MIT",
+  "author": "SceneView (https://github.com/SceneView)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SceneView/sceneview-android.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://github.com/SceneView/sceneview-android/tree/main/mcp#readme",
+  "bugs": {
+    "url": "https://github.com/SceneView/sceneview-android/issues"
+  },
   "type": "module",
   "bin": {
     "sceneview-mcp": "dist/index.js"
@@ -12,6 +34,9 @@
     "dist",
     "llms.txt"
   ],
+  "engines": {
+    "node": ">=18"
+  },
   "scripts": {
     "build": "tsc",
     "prepare": "cp ../llms.txt ./llms.txt && tsc",