Enables AI assistants to write declarative 3D and AR code for Android, iOS, Web, Flutter, and React Native applications.
Also known as sceneview/sceneview, sceneview-mcp
- Stars
- 1,374
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 3.4.7
- Last commit
- Nov 16, 2026
- License
- Apache-2.0
What is SceneView MCP?
SceneView enables AI assistants to write declarative 3D and AR code for Android, iOS, Web, Flutter, and React Native applications. It exposes 13 tools, such as get_sample, list_samples, get_setup.
Summary generated from the project's README
About SceneView MCP server
Developers building immersive mobile and web applications can use this MCP server to generate declarative 3D and augmented reality code. It serves as an AI-first bridge for integrating high-quality models into Android, iOS, Web, Flutter, and React Native projects without requiring a full game engine. The server enables AI assistants to write functional code for various frameworks, including Jetpack Compose, SwiftUI, and Compose Multiplatform.
To use this server, developers can add it to clients like Claude Code or Codex using the npx command. Once connected, an AI assistant can directly implement features such as 3D model viewers or AR placement scenes. The server is designed to work with the SceneView SDK, which utilizes Filament, ARCore, and RealityKit depending on the target platform. It provides specific implementations for Android 3D and AR, iOS, and web-based viewers using Filament.js.
What you can do with it
- 1Add 3D model viewersAsk an AI assistant to integrate a 3D model viewer into a Jetpack Compose screen.
- 2Cross-platform 3D developmentGenerate code for displaying 3D assets in Flutter or React Native applications.
- 3Web-based 3D renderingInstruct an assistant to set up a model viewer on a web canvas using JavaScript.
Written from the project's README. Every use case is checked against a quote from it.
How to install SceneView MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall SceneView MCP in Claude Code
$ claude mcp add mcp -- npx -y sceneview-mcpInstall SceneView MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"sceneview-mcp"
]
}
}
}Install SceneView MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"sceneview-mcp"
]
}
}
}Install SceneView MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","sceneview-mcp"]}'Install SceneView MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"sceneview-mcp"
]
}
}
}Install SceneView MCP in Codex
$ codex mcp add mcp -- npx -y sceneview-mcpInstall SceneView MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "sceneview-mcp"]
Install SceneView MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y sceneview-mcpInstall SceneView MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"sceneview-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for sceneview-mcp 3.4.4 in an isolated container with no network and no keys. It answered and listed 13 tools.
SceneView MCP tools 13
Read from the server with tools/listget_sampleReturns a complete, compilable Kotlin sample for a given SceneView scenario. Use this to get a working starting point before customising. Call `list_samples` first if you are unsure which scenario fits.
list_samplesLists all available SceneView code samples with their IDs, descriptions, and tags. Use this to find the right sample before calling `get_sample`, or to show the user what SceneView can do.
get_setupReturns the Gradle dependency and AndroidManifest snippet required to use SceneView in an Android project.
validate_codeChecks a Kotlin or Swift SceneView snippet for common mistakes. For Kotlin: threading violations, wrong destroy order, missing null-checks, LightNode trailing-lambda bug, deprecated 2.x APIs. For Swift: missing @MainActor, async/await patterns, missing imports, RealityKit mistakes. Language is auto-detected. Always call this before presenting generated SceneView code to the user.
get_migration_guideReturns the full SceneView 2.x → 3.0 migration guide. Use this when a user reports code that worked in 2.x but breaks in 3.0, or when helping someone upgrade.
get_node_referenceReturns the full API reference for a specific SceneView node type or composable — parameters, types, and a usage example — parsed directly from the official llms.txt. Use this when you need the exact signature or options for a node (e.g. ModelNode, LightNode, ARScene). If the requested type is not found, the response lists all available types.
get_platform_roadmapReturns the SceneView multi-platform roadmap — current Android support status, planned iOS/KMP/web targets, and timeline. Use this when the user asks about cross-platform support, iOS, Kotlin Multiplatform, or future plans.
get_best_practicesReturns SceneView performance and architecture best practices — memory management, model optimization, threading rules, Compose integration patterns, and common anti-patterns. Use this when the user asks about performance, optimization, best practices, or architecture.
get_ar_setupReturns detailed AR setup instructions — AndroidManifest permissions and features, Gradle dependencies, ARCore session configuration options (depth, light estimation, instant placement, plane detection, image tracking, cloud anchors), and a complete working AR starter template. More detailed than `get_setup` for AR-specific configuration.
get_troubleshootingReturns the SceneView troubleshooting guide — common crashes (SIGABRT, model not showing), build failures, AR issues (drift, overexposure, image detection), and performance problems. Use this when a user reports something not working, a crash, or unexpected behavior.
get_ios_setupReturns the complete iOS setup guide for SceneViewSwift — SPM dependency, Package.swift example, minimum platform versions, Info.plist entries for AR (camera permission), and basic SwiftUI integration code. Use this when a user wants to set up SceneView for iOS, macOS, or visionOS.
get_web_setupReturns the complete Web setup guide for SceneView Web — npm install, Kotlin/JS Gradle config, HTML canvas setup, and basic Filament.js integration code. SceneView Web uses the same Filament rendering engine as Android, compiled to WebAssembly. Use this when a user wants to set up SceneView for browsers.
Show all 13 toolsShow fewer tools
render_3d_previewGenerates an interactive 3D preview link. Accepts a model URL, a SceneView code snippet, or both. Returns a URL to sceneview.github.io/preview that renders the model in the browser with orbit controls, AR support, and sharing. For model URLs: embeds a model-viewer link directly. For code snippets: shows the 3D preview with the code in a companion panel. Use this when you want to show a 3D model to the user — paste the link in your response and they can click to see it live.
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablesceneview/sceneview is public and reachablegithub.com/sceneview/sceneview ↗Pass
- Package names this repository as its sourcesceneview-mcp names sceneview/sceneview as sourcenpmjs.com/package/sceneview-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-16github.com/sceneview/sceneview ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from sceneview-mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubSceneView
The AI-first 3D & AR SDK for Jetpack Compose, Compose Multiplatform, SwiftUI and the web.
Declarative 3D and AR for app developers who want a model on screen, or in the room, without a game engine: Filament + ARCore on Android, RealityKit + ARKit on Apple, Filament.js + WebXR in the browser — with Flutter, React Native and Compose Multiplatform bridges on top. It is the maintained successor to Google Sceneform. Open source, Apache 2.0.
| Building with | Add | Then write |
|---|---|---|
| Jetpack Compose — 3D | io.github.sceneview:sceneview:4.68.0 |
SceneView { } |
| Jetpack Compose — AR | io.github.sceneview:arsceneview:4.68.0 |
ARSceneView { } or PlacementScene |
| Android Views / XML | the same | SceneView { } inside a ComposeView |
| Kotlin / Compose Multiplatform | io.github.sceneview:sceneview-compose:4.68.0 |
SceneViewer(model = …) in commonMain |
| SwiftUI — iOS, macOS, visionOS | Swift Package https://github.com/sceneview/sceneview.git |
SceneView { }, ARSceneView |
| Web | npm install sceneview-web |
SceneView.modelViewer("canvas", "model.glb") |
Moving from Sceneform, or from SceneView 2.x code (Scene(childNodes = …), ARScene)?
The mapping. Which artifact fits your app:
3D and AR library, per platform.
Used in production. More than 1,300 stars on GitHub, and over 500 public repositories declare SceneView as a dependency. It ships in Medal, IKEA, Lenskart and Safie on Google Play, is declared by the open-source apps Bitkey (Block) and Vocable (WillowTree), and is a dependency of the GeneXus Augmented Reality module and the TruVideo camera SDK. The Niantic Spatial SDK samples use it for AR.
AI-first means one thing here: an assistant that reads llms.txt or
the MCP server writes SceneView code that works on the first try. When it doesn't, the
API or the doc gets fixed.
Try it
The demo apps are built from samples/. Any demo opens straight from a link:
https://sceneview.github.io/open?demo=<id>. Start with
Cosmos, the galaxy the catalogue opens on, or
3D Scan, a space scanned with ARCore and rebuilt in 3D.
Help test the demos
Install the Android demo, record your screen while you use a demo, and tell us what breaks or confuses you: open an issue with the recording attached, or send it from the app (any demo, Settings, then Send feedback).
Quick start
One minimal, working example per platform. The full reference for each is in
llms.txt.
Android
// build.gradle.kts
implementation("io.github.sceneview:sceneview:4.68.0")
The app module needs compileSdk = 37, minSdk 24 or higher, AGP 9.4.0+, Kotlin 2.3 or newer and JVM
target 21 for both Java and Kotlin: SceneView ships Java 21 bytecode with public inline
functions. The quickstart requirements give the Gradle
snippet and the reason for each.
Stuck on AGP 8 / compileSdk 36 / Kotlin 2.2? Use 4.18.0, the newest release that builds there.
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.Composable
import androidx.compose.ui.Modifier
import io.github.sceneview.SceneView
import io.github.sceneview.rememberModelInstance
@Composable
fun ModelScreen() {
SceneView(modifier = Modifier.fillMaxSize()) { // orbit camera + default lighting
rememberModelInstance(modelLoader, "models/helmet.glb")?.let { instance ->
ModelNode(modelInstance = instance, scaleToUnits = 1.0f, autoAnimate = true)
}
}
}
models/helmet.glb lives in src/main/assets/. rememberModelInstance returns null until the
model is loaded, then recomposes. Never call modelLoader.createModel* from a background
coroutine: Filament calls must run on the main thread, and rememberModelInstance handles that.
AR (Android)
// build.gradle.kts
implementation("io.github.sceneview:arsceneview:4.68.0") // includes the 3D module
import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import com.google.ar.core.Anchor
import com.google.ar.core.Plane
import io.github.sceneview.ar.ARSceneView
import io.github.sceneview.ar.arcore.createAnchorOrNull
import io.github.sceneview.ar.arcore.getUpdatedPlanes
import io.github.sceneview.rememberModelInstance
@Composable
fun ARScreen() {
var anchor by remember { mutableStateOf<Anchor?>(null) }
ARSceneView(
modifier = Modifier.fillMaxSize(),
planeRenderer = true,
onSessionUpdated = { _, frame ->
if (anchor == null) {
anchor = frame.getUpdatedPlanes()
.firstOrNull { it.type == Plane.Type.HORIZONTAL_UPWARD_FACING }
?.let { it.createAnchorOrNull(it.centerPose) }
}
}
) {
val helmet = rememberModelInstance(modelLoader, "models/helmet.glb")
anchor?.let { a ->
AnchorNode(anchor = a) {
helmet?.let { ModelNode(modelInstance = it, scaleToUnits = 0.5f) }
}
}
}
}
Plane detected → anchor set → Compose recomposes → the model appears. AR state is just Kotlin
state. For placement without a tap, grounded and gesture-ready, start from
AutoPlacementScene (see llms.txt).
arsceneview already declares the CAMERA permission and marks ARCore as optional. An AR
Optional app declares android.hardware.camera.ar and android.hardware.camera as
<uses-feature … android:required="false" />; an AR Required app overrides the ARCore value
with tools:replace="android:value". Both snippets are in the
AR manifest section.
iOS / macOS / visionOS (SwiftUI)
Swift Package Manager: https://github.com/sceneview/sceneview.git, from 4.63.0.
import SwiftUI
import SceneViewSwift
struct ModelScreen: View {
@State private var model: ModelNode?
var body: some View {
SceneView { root in
if let model { root.addChild(model.entity) }
}
.contentID(model != nil) // re-run the builder once the model has loaded
.environment(.studio)
.cameraControls(.orbit)
.task { model = try? await ModelNode.load("helmet.usdz") }
}
}
The content closure runs once unless its .contentID(_:) changes: without that line, a model
that finishes loading after the scene appears is never added.
Web
<canvas id="viewer" style="width: 100%; height: 480px"></canvas>
<script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.68.0/website-static/js/filament/filament.js"></script>
<script src="https://cdn.jsdelivr.net/gh/sceneview/sceneview@v4.68.0/website-static/js/sceneview.js"></script>
<script> SceneView.modelViewer("viewer", "model.glb") </script>
Compose Multiplatform (Android · iOS · desktop)
// commonMain dependencies
implementation("io.github.sceneview:sceneview-compose:4.68.0")
SceneViewer(model = ModelSource.Asset("models/helmet.glb"), modifier = Modifier.fillMaxSize())
A viewer by design — load, orbit, light, tap; no AR. Scope and the one-time iOS setup:
sceneview-compose/.
Flutter
// pubspec.yaml → flutter_sceneview: ^4.68.0
final controller = SceneViewController();
SceneView(
controller: controller,
onViewCreated: () => controller.loadModel(
const ModelNode(modelPath: 'models/helmet.glb'),
),
)
React Native
// npm install @sceneview-sdk/react-native
import { SceneView } from '@sceneview-sdk/react-native';
<SceneView
style={{ flex: 1 }}
modelNodes={[{ src: 'models/helmet.glb', position: [0, 0, -2] }]}
cameraControlMode="orbit"
/>
Flutter and React Native bridge a subset of the native API — see
flutter/ and
react-native/ for what is covered.
Your AI assistant
claude mcp add sceneview -- npx -y sceneview-mcp # Claude Code
codex mcp add sceneview -- npx -y sceneview-mcp # Codex
Then ask: "Add a 3D model viewer to my Compose screen." Every other client is in Use with AI.
Runs on
Each row is a published package plus an app or page you can open today, backed by a real capture of it.
| Platform | Status | Install | Open it | Capture |
|---|---|---|---|---|
| Android | Shipped · Stable | Maven Central | Google Play | |
| iOS | Shipped · Alpha | Swift Package | App Store | |
| Web | Shipped · Alpha | npm sceneview-web |
Live web demo |
Shipped means released and publicly reachable; the second word is the API maturity. The other platforms in the table below join this section once a capture backs them.
Platforms
| Platform | Renderer | Framework | Status |
|---|---|---|---|
| Android | Filament | Jetpack Compose | Stable |
| Android TV | Filament | Compose TV | Alpha |
| iOS / macOS / visionOS | RealityKit | SwiftUI | Alpha |
| Web | Filament.js (WebGL2 / WASM) | JavaScript + Kotlin/JS | Alpha |
| Compose Multiplatform | Filament (Android, desktop) · RealityKit (iOS) | sceneview-compose |
Alpha — viewer subset |
| Desktop (JVM) | Filament, via filament-kmp | Compose Desktop (sceneview-compose) |
Alpha |
| Flutter | Native per platform | PlatformView | Alpha |
| React Native | Native per platform | Fabric | Alpha |
| AI assistants | — | llms.txt, MCP server, skills |
Stable |
Install
| Platform | Coordinate |
|---|---|
| Android 3D | io.github.sceneview:sceneview:4.68.0 |
| Android AR | io.github.sceneview:arsceneview:4.68.0 |
| Compose Multiplatform | io.github.sceneview:sceneview-compose:4.68.0 |
| KMP core only (math, collision, physics) | io.github.sceneview:sceneview-core:4.68.0 |
| Apple (SPM) | https://github.com/sceneview/sceneview.git, from 4.63.0 |
| Web, script tag | the two <script> tags in Web |
| Web, bundler (Kotlin/JS) | npm install sceneview-web — see SceneView Web |
| Flutter | flutter_sceneview on pub.dev |
| React Native | @sceneview-sdk/react-native on npm |
| AI assistants | npx -y sceneview-mcp — see Use with AI |
Use with AI
Everything an assistant needs to write SceneView code ships with the SDK:
llms.txt— the complete API reference in one file: composables, every node type, threading rules, recipes. Its Kotlin snippets are compiled in CI. Served athttps://sceneview.github.io/llms.txtfor tools without MCP support.- Rules files —
AGENTS.md(Codex, Cursor, GitHub Copilot, Gemini in Android Studio and others),CLAUDE.md(Claude Code),.github/copilot-instructions.md, and.cursorrulesfor older Cursor versions. - The MCP server — free, no API key. The tools assistants reach for most:
validate_code(checks a snippet for known pitfalls and unknown symbols before you run it; it does not check argument names),get_node_reference(the exact node signature, not an invented one),list_samples/get_sample(38 samples to start from), andget_setup/get_ar_setup(project wiring).
MCP setup
claude mcp add sceneview -- npx -y sceneview-mcp # Claude Code
codex mcp add sceneview -- npx -y sceneview-mcp # Codex
copilot mcp add sceneview -- npx -y sceneview-mcp # GitHub Copilot CLI
// Cursor (.cursor/mcp.json), Cline, JetBrains AI Assistant
{ "mcpServers": { "sceneview": { "command": "npx", "args": ["-y", "sceneview-mcp"] } } }
// VS Code (.vscode/mcp.json) uses the "servers" key instead
{ "servers": { "sceneview": { "type": "stdio", "command": "npx", "args": ["-y", "sceneview-mcp"] } } }
Clients that only speak HTTP (Gemini in Android Studio, ChatGPT) use the hosted endpoint
https://mcp.sceneview.dev/mcp, or run their own with npx sceneview-mcp --http. Per-client
snippets: sceneview.github.io/#ai-setup. Listed on the
MCP Registry.
ChatGPT / Codex plugin
This repository is also an OpenAI plugin: .codex-plugin/plugin.json points at the three
skills under agents/ (sceneview, sceneview-ios, sceneview-web). From a
checkout:
codex plugin marketplace add "$PWD" # absolute path — a relative one does not resolve
codex plugin add sceneview@sceneview-local
Codex also discovers the skills from .agents/skills/ on its own. Over HTTP the MCP server
carries an inline view_3d_model widget that renders a public GLB/glTF URL in the
conversation. Listing copy and test prompts: agents/OPENAI-PLUGIN.md.
Claude Code plugin
/plugin marketplace add sceneview/claude-marketplace, then /plugin install sceneview@sceneview,
installs the same three skills as the Codex plugin together with the MCP server. The commands used
to work on this repository are a separate plugin, sceneview-contrib@sceneview — see
sceneview/claude-marketplace.
Vertical MCP servers (Rerun AR debugging and others) are listed in the MCP README.
Android in depth
3D scene
SceneView is a composable that renders a Filament viewport. Nodes are composables inside it.
val engine = rememberEngine()
val modelLoader = rememberModelLoader(engine)
val environmentLoader = rememberEnvironmentLoader(engine)
SceneView(
modifier = Modifier.fillMaxSize(),
engine = engine,
modelLoader = modelLoader,
environment = rememberEnvironment(environmentLoader) {
environmentLoader.createHDREnvironment("envs/studio.hdr")
?: createEnvironment(environmentLoader)
},
cameraManipulator = rememberCameraManipulator()
) {
// Model — async loaded, appears when ready
rememberModelInstance(modelLoader, "models/helmet.glb")?.let {
ModelNode(modelInstance = it, scaleToUnits = 1.0f, autoAnimate = true)
}
// Geometry — procedural shapes
CubeNode(size = Size(0.2f))
SphereNode(radius = 0.1f, position = Position(x = 0.5f))
// Nesting — same as Column { Row { } }
Node(position = Position(y = 1.0f)) {
LightNode(type = LightManager.Type.POINT, apply = { intensity(50_000f) })
CubeNode(size = Size(0.05f))
}
}
Node composables — 27 in 3D, 15 more in AR
| Category | Nodes | What they do |
|---|---|---|
| Models | ModelNode |
glTF/GLB with skeletal/morph animations. isEditable = true for gestures. |
| Primitives | CubeNode · SphereNode · CylinderNode · ConeNode · TorusNode · CapsuleNode · TubeNode · PlaneNode |
Procedural geometry, parametric size/segments |
| Curves & shapes | LineNode · PathNode · ShapeNode |
Single segments, polylines, extruded 2D polygons |
| Custom geometry | MeshNode |
Your own Filament VertexBuffer / IndexBuffer |
| Surfaces | ImageNode · VideoNode · BillboardNode |
PNG/JPG plane, video plane (MediaPlayer), camera-facing sprite |
| 3D text | TextNode |
World-space text label that always faces the camera |
| Compose-in-3D | ViewNode |
Any Compose UI rendered as a 3D surface, fully touch-interactive |
| Gaussian splats | SplatNode |
Render a Gaussian-splat capture |
| Lighting & sky | LightNode · ReflectionProbeNode · DynamicSkyNode · FogNode |
Sun/dir/point/spot lights, local IBL, time-of-day sky, atmospheric fog |
| Physics | PhysicsNode |
Simple rigid-body simulation (gravity, collisions) |
| Cameras | CameraNode · SecondaryCamera |
Main and picture-in-picture cameras |
| Group | Node |
Empty pivot for nesting and transform inheritance |
AR scene
ARSceneView is SceneView with ARCore: the camera follows real-world tracking. See the
AR quick start above.
| Node | What it does |
|---|---|
AnchorNode |
Pin a node to a real-world ARCore Anchor |
HitResultNode · DepthHitResultNode |
Live surface cursor from each frame's hit-test (planes or depth) |
PoseNode |
Position a node at any ARCore Pose |
PlaneNode · ReticleNode |
Render a detected plane, or a placement reticle |
PointCloudNode · DepthMeshNode · SceneMeshNode |
Feature points, depth mesh, classified geospatial scene mesh |
AugmentedImageNode |
Image tracking — pose + 2D extent of a detected image |
AugmentedFaceNode |
Face mesh overlay (front camera) |
CloudAnchorNode |
Persistent cross-device anchor (host + resolve) |
StreetscapeGeometryNode |
Geospatial — semantic city mesh (buildings, terrain) |
TerrainAnchorNode |
Geospatial — anchor pinned to ground at a lat/lng |
RooftopAnchorNode |
Geospatial — anchor pinned to a building rooftop |
| Feature | API surface |
|---|---|
| Automatic placement | AutoPlacementScene + AutoPlacementModel — grounded, gesture-ready, no tap |
| Plane / depth / instant placement | ARSceneView(planeRenderer = …, depthMode = …, instantPlacementMode = …) |
| Geospatial (VPS) | Streetscape + Terrain + Rooftop anchors via Earth session |
| Cloud Anchors | CloudAnchorNode.host(ttlDays = N) + .resolve(id) |
| Augmented Faces & Images | AugmentedFaceNode, AugmentedImageDatabase, runtime image add |
| Image Stabilization (EIS) | ARSceneView(imageStabilizationMode = ImageStabilizationMode.EIS) |
| Camera exposure & focus | ARSceneView(sessionCameraConfig = …, focusMode = …, cameraExposure = …) |
| Record & Replay | rememberARRecorder() to capture, ARSceneView(playbackDataset = file) to replay 1:1 — see AR debugging |
| Rerun.io live debug | rememberRerunBridge() streams poses, planes and point clouds to the Rerun viewer |
| Permission flow | ARPermissionHandler — auto-detected from ComponentActivity |
Capabilities
| Capability | What it gives you | Where it lives |
|---|---|---|
| Gestures | Drag, pinch-to-scale, two-finger rotate, elevate, tap. Per-node opt-in via isEditable. |
NodeGestureDelegate, OnGestureListener |
| Animations | Skeletal/morph from glTF, plus per-node spring/property/smooth-transform. | ModelNode.playAnimation(), NodeAnimationDelegate |
| Physics | Rigid-body dynamics — gravity, collisions, impulses. Pure Kotlin Multiplatform, no JNI. | PhysicsNode, sceneview-core |
| Collision & raycasting | Ray vs box / sphere intersections, hit-testing, frustum culling. | CollisionSystem, Ray, Box, Sphere |
| Procedural geometry | Cube/sphere/cylinder/cone/torus/capsule generators, extrusion from 2D shapes (Earcut + Delaunator). | sceneview-core geometry + triangulation |
| HDR environment | IBL lighting + skybox from .hdr / .ktx. Async load + reactive swap. |
EnvironmentLoader, rememberEnvironment |
| Custom materials | Filament .filamat materials with parameters, plus built-in unlit / lit / overlay variants. |
MaterialLoader |
| Post-processing | Bloom, depth of field, SSAO, vignette, color grading, tone mapping. | View.bloomOptions, dynamicResolutionOptions, … |
| Compose UI in 3D | Any @Composable as a textured plane in world space. Touches are forwarded, so Button.onClick, ripples and inner scrolling work. |
ViewNode + ViewNode.WindowManager |
| Multiple cameras | Picture-in-picture, mini-map, security-camera views. | SecondaryCamera |
| Reactive scene graph | Change state → the tree updates. No imperative parent.addChild(). |
SceneScope / ARSceneScope DSL |
SceneView MCP questions
How do I add SceneView MCP to Claude Code?
Run claude mcp add mcp -- npx -y sceneview-mcp in your terminal. Add --scope user to make it available in every project.
How do I add SceneView MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does SceneView MCP provide?
It exposes 13 tools, including get_sample, list_samples, get_setup, validate_code, get_migration_guide.
How do I add SceneView to my Claude Code environment?
You can add it using the command: claude mcp add sceneview -- npx -y sceneview-mcp
What platforms does SceneView support?
SceneView supports Android (Jetpack Compose and Views), iOS (SwiftUI, macOS, visionOS), Web, Compose Multiplatform, Flutter, and React Native.
Is SceneView an open source project?
Yes, SceneView is open source under the Apache 2.0 license.