worldlabs-mcp
mcp
Warn
Health Warn
- No license — Repository has no license file
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 5 GitHub stars
Code Pass
- Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
Purpose
This server acts as an MCP gateway and webapp for the World Labs Marble API. It allows users to generate, render, and navigate interactive 3D worlds from text, images, or video inputs.
Security Assessment
Overall Risk: Medium. The code itself is relatively clean; an automated scan of 12 files found no dangerous patterns, hardcoded secrets, or dangerous permission requests. However, by design, the tool makes external network requests to the World Labs API and requires a `WORLDLABS_API_KEY` environment variable. Passing proprietary API keys through a low-visibility, experimental wrapper inherently carries a moderate risk, as the server handles your sensitive authentication credentials.
Quality Assessment
The project is very new and currently lacks community validation, evidenced by only 5 GitHub stars. While the repository is highly active (the last push was today) and features impressively comprehensive documentation, it critically lacks an open-source license. This means that, strictly legally, all rights are reserved by the creator and you have no explicit permission to use, modify, or distribute the code.
Verdict
Use with caution — the code appears safe without hidden exploits, but you should be careful passing API keys through it, and you must note the strict legal limitations of having no software license.
This server acts as an MCP gateway and webapp for the World Labs Marble API. It allows users to generate, render, and navigate interactive 3D worlds from text, images, or video inputs.
Security Assessment
Overall Risk: Medium. The code itself is relatively clean; an automated scan of 12 files found no dangerous patterns, hardcoded secrets, or dangerous permission requests. However, by design, the tool makes external network requests to the World Labs API and requires a `WORLDLABS_API_KEY` environment variable. Passing proprietary API keys through a low-visibility, experimental wrapper inherently carries a moderate risk, as the server handles your sensitive authentication credentials.
Quality Assessment
The project is very new and currently lacks community validation, evidenced by only 5 GitHub stars. While the repository is highly active (the last push was today) and features impressively comprehensive documentation, it critically lacks an open-source license. This means that, strictly legally, all rights are reserved by the creator and you have no explicit permission to use, modify, or distribute the code.
Verdict
Use with caution — the code appears safe without hidden exploits, but you should be careful passing API keys through it, and you must note the strict legal limitations of having no software license.
FastMCP 3.2 server and webapp wrapping the World Labs Marble API — generate navigable 3D worlds from text, images, and video
README.md
worldlabs-mcp (v0.4.0)
MCP gateway to World Labs Marble + Spark 2.0. Generate navigable 3D worlds from text, images, panoramas, multi-view sets, or video; view them with a streaming Gaussian-splat renderer; and ground a voice agent in scene coordinates.
🚀 Quick Start
- Setup:
uv pip install -e ".[dev]" - Key: Set
WORLDLABS_API_KEYenvironment variable (get one at https://platform.worldlabs.ai/api-keys). - Launch:
python scripts/run_server.py
🏛️ Core Engines (v0.4.0)
- Marble (LWM): The Large World Model foundation. Generatively persistent reconstructed worlds with coordinate consistency.
- Spark 2.0 (Renderer): Hierarchical LoD splat trees with virtual GPU memory paging. Handles 100M+ primitives.
- Chisel (Geometry): Geometric distillation pipeline for extracting watertight physics proxies and triangular meshes from radiance fields.
💎 Features
Shipping
- Marble 1.1 + 1.1-plus world generation from text, image, multi-image, video, or local file upload.
- Spark 2.0 Spatial Engine — High-fidelity Gaussian-splat streaming (
.rad/.spz) with hierarchical LoD and virtual GPU paging. - Industrial Toolbox: Persistent Scene Baking (Persistence), Blender DCC Handshake, and Sovereign Art Gallery.
- Plex Cinema: Authenticated media streaming from
plex-mcpto in-world 5.5m cinematic surfaces. - Sovereign Command Console: Interactive 3D terminal with live CPU/MEM/VRAM hardware telemetry.
- World Portals: Seamless TORUS-frame world jumping with procedural "Latent Ripple" shaders.
- Spatial Voice Agent: Integrated WebAudio HRTF (Gemini 3.1 Flash TTS) for coordinate-grounded narration.
Under Refinement
- Automatic Grounding: Chisel-based raycast physics for complex imported Blender meshes.
- DCC Live Link: Real-time transformation sync between Blender and the Spark Viewer.
📚 Documentation
- 📥 Installation
- 🏗️ Architecture
- 🌐 World Modeling — spatial intelligence market context
- 🎙️ Spatial Voice & TTS — Gemini 3.1 Flash TTS + WebAudio HRTF
- 🥽 VR & WebXR
- ⚡ Spark 2.0 — LoD splat tree,
.RADstreaming format
🛠️ Tools (16)
| Group | Tool |
|---|---|
| generate | generate_world_from_text, generate_world_from_image, generate_world_from_multi_image, generate_world_from_video, generate_world_from_media_asset |
| upload | upload_and_generate, prepare_media_upload |
| poll | get_operation, wait_for_world |
| world | list_worlds, get_world |
| spatial | broadcast_spatial_notification, broadcast_spatial_audio, place_world_tv, spawn_agent_avatar |
| meta | worldlabs_help |
🛡️ Quality
Ruff for Python, Biome for Web, Just for automation. Pytest + pytest-httpx for the Marble wrapper. FastMCP 3.2+ with Prefab UI for in-chat rich tool results.
MIT License • Maintained by sandraschi. Not affiliated with World Labs.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found