u-space-mcp

Model Context Protocol server for the u-space documentation, including u-manager APIs and examples such as UManagerLoader, examples/test_umanager_loader.html, examples/test_umanager_dynamic_instances.html, SemanticInstanceObject, SemanticModelInstancedLayer, SceneLoader semantic-id dedupe and path-based model instancing, SceneInstanceObject, SceneInstancedLayer, SemanticLoader, SemanticGroup, BuildingGroup, FloorMesh, FacilityInstanceObject, FacilityInstancedLayer, scene-level Facilities auto instancing, floor-mounted facility lookup/control, semantic elevator/vent shafts, per-kind floor-plane planishing for semantic instances and Facilities, atmosphere skyBackground() / skyEnvironment() output-effect setup, fire FireEffect WebGPU volumetric fire/smoke simulation, and core object defaults like BaseMesh shadow behavior.

The bundled docs index includes detailed UManagerLoader, UManagerSceneGroup direct semanticGroup / sceneGroup properties, SemanticGroup.getDefaultFacilityLayer(), SceneGroup.getDefaultSceneLayer(), SceneLoader, SceneInstanceObject fields and inherited semantic APIs (semanticId / semanticKind / semanticName, setSemanticIdentity(), setSemanticVisible(), setSemanticColor(), setSemanticOpacity(), setSemanticHighlight(), getSemanticBoundingBox(), object-level boundingBox / boundingSphere / computeBoundingBox() / computeBoundingSphere(), dirty callbacks, and fallback render-object access), and Facilities reference material for the unified SemanticInstanceObject API, the runnable test_umanager_loader.html and test_umanager_dynamic_instances.html examples, flying a camera to path-instanced scene objects or Facilities through objectManager.getById() and controls.flyToObject(), shared SemanticModelInstancedLayer dynamic batch APIs (getSemanticInstances(), getSemanticInstanceById(), reserveSemanticBatch(), addSemanticInstance() / addSemanticInstances(), removeSemanticInstance() / removeSemanticInstances() with single-string semantic ids, removeSemanticBatch(), clearSemanticBatches()), duplicate semanticId rejection, id-index refresh after identity changes, capacity-based instance growth, dirty-driven instance synchronization including transform-to-instance-matrix sync before rendering, unsupported-model fallback wrappers, SemanticGroup / BuildingGroup / FloorMesh lookups backed by object semanticId fields instead of userData aliases, instanced raycast hit remapping without reading ids from instance.userData, plus FireEffect emitter setup, simulation/grid options, volumetric pass bounds, dynamic lights, and RenderPipeline output-effect integration.

Usage

{
  "mcpServers": {
    "uSpace": {
      "command": "npx",
      "args": ["-y", "u-space-mcp@latest"]
    }
  }
}

For local documentation development, point the server at a local docs directory:

{
  "mcpServers": {
    "uSpace": {
      "command": "npx",
      "args": ["-y", "u-space-mcp@latest", "--docs", "/path/to/u-space/docs"]
    }
  }
}

Tools

• list_docs
• search_docs
• get_doc
• get_api_reference
• find_examples
• get_changelog

All tools are read-only.