Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Overte

БесплатноНе проверен

An MCP server for the Overte social-VR platform, enabling real-time querying of domain status, spawning in-world entities, and injecting JavaScript scripts thro

GitHubEmbed

Описание

An MCP server for the Overte social-VR platform, enabling real-time querying of domain status, spawning in-world entities, and injecting JavaScript scripts through a WebSocket bridge.

README

License: MIT Python 3.12+ Status: beta, core tools verified live

What this wraps

An MCP server for Overte, the open-source social-VR platform — a C++ desktop client ("Interface") + domain-server + entity-server, descended from High Fidelity's codebase. Not the same thing as current "Vircadia" — see docs/WRAPPEE.md for the full disambiguation and official links (site, docs, community). Complements the fleet's other virtual-world servers: resonite-mcp, vrchat-mcp, godot-mcp, unity3d-mcp, gazebo-mcp.

Plus a companion React web dashboard.

Local sandbox or join a domain

Two ways to be in a world — the dashboard keeps them separate on purpose:

  • Local sandbox (default): your own domain-server on this machine (localhost:40100). Private, free, and the only setup where the dashboard's Start/Stop buttons can launch things for you.
  • Join a domain: point the dashboard's Watching switcher at someone else's domain-server (host + admin port) to monitor it, and join it in Interface with Connect to Domain…. You get admin/scripting power there only if they gave you credentials.

One rule for both: spawning, injecting, and animating always act through the bridge, which lives in whatever domain your assignment-client or Interface joined. The Watching switcher changes which domain you look at; your spawns land where you stand. To flip it around — host a domain others can join, gate it to specific people, and send hifi:// invites — see docs/ONBOARDING.md ("Hosting a domain others can join") and the Help Hub in the dashboard.

What You Can Do

How it runs: Overte (domain-server + assignment-client, optionally Interface) is a separate application you install yourself, never bundled. Entity work runs through a bridge script inside Overte's script engine. Since 2026-10-31 the bridge runs headless as a domain persistent script on an assignment-client: no GUI, no logged-in user (overte_bridge_install sets it up). Loading it in the desktop Interface client still works when you want to watch. See docs/ONBOARDING.md.

Direction Artifacts Notes
Hands-in Entity properties (position, scale, type), JS behavior scripts, GLB/FBX/OBJ model URLs Via MCP tool calls or the dashboard's Entities/Scripting pages
Hands-out Live domain-server telemetry, spawned in-world entities, animated/scripted entities Real result or an error saying why (bridge_not_connected, domain_unreachable, ...); no simulated mode

Tools — 12 MCP tools (verified live against Overte 2026.04.1 unless noted):

Tool Status
overte_domain_status Verified live (2026-07-30): domain-server /nodes.json + /settings.json on port 40100
overte_bridge_status / overte_bridge_install New 2026-10-31: bridge mode (agent/interface) and headless install as a persistent script. See STATUS.md for live verification state.
overte_entity_spawn Verified live — in-world entity spawning via WebSocket bridge; permanent=True for cross-restart persistence
overte_script_inject Verified live — in-world JS behavior injection via WebSocket bridge
overte_entity_update / delete / animate Live-only entity lifecycle (move/resize, delete, spin/bob/bounce)
overte_nearby_entities / fixture_spawn Live world search + gripper test fixtures (box/cup/ball/table/chair)
overte_sampling_assist Multi-step planning via ctx.sample() when host supports it
overte_shutdown Orderly self-termination (confirm=True) + POST /api/shutdown

Dashboard pages:

Page Route Features
Dashboard / Domain status, node list, settings viewer
Avatars /avatars Connected avatar-mixer/agent nodes
Entities /entities Spawn form + entity explorer
Scripting /scripting JS code editor + script injection
Chat /chat Skill-first LLM chat with 4 personalities
Settings /settings Backend health + LLM provider detection
Tools /tools Dynamic tool discovery + search
Skills /skills Skill content viewer (markdown)
Logs /logs Ring-buffer log viewer with level filter
Inbox /inbox Server events needing attention (search/filter/sort/paginate)
Help /help Domain setup, hosting + invites, JS API reference

Quick Install

Claude Desktop (.mcpb) — Claude-only one-liner

irm https://github.com/sandraschi/overte-mcp/releases/latest/download/install.ps1 | iex

One command: downloads the latest .mcpb, installs Python/uv if missing, and registers the bundle. Claude Desktop only.

Other clients (Cursor / VS Code / Codex / Opencode) — no bundle needed:

{
  "mcpServers": {
    "overte-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/sandraschi/overte-mcp.git", "overte-mcp"]
    }
  }
}

From source: just mcpb-pack → dist/overte-mcp.mcpb, then drag the .mcpb into Claude Desktop. Full install paths: INSTALL.md.

Full stack (dashboard + bridge)

./start.ps1

Syncs deps, starts FastAPI backend (11110) and Vite dashboard (11111), opens the browser. Then start Overte domain-server.exe and assignment-client.exe -n 9, and run overte_bridge_install once. Or let just e2e-headless do it all and report pass/fail. See docs/ONBOARDING.md.

Example Prompts

  • "What's the status of my Overte domain?"
  • "Spawn a permanent box entity at the origin"
  • "Attach the dance script to that entity"

Lint / test

just lint      # Ruff + Biome
just test      # unit + e2e
just mcpb-pack # validate + pack Claude Desktop bundle

Documentation

Requirements

License

MIT

from github.com/sandraschi/overte-mcp

Установка Overte

У этого сервера нет опубликованного пакета — он собирается из исходников. Открой репозиторий и следуй инструкции в README.

▸ github.com/sandraschi/overte-mcp

FAQ

Overte MCP бесплатный?

Да, Overte MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Overte?

Нет, Overte работает без API-ключей и переменных окружения.

Overte — hosted или self-hosted?

Self-hosted: сервер запускается локально на твоей машине командой из раздела установки.

Как установить Overte в Claude Desktop, Claude Code или Cursor?

Открой Overte на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Overte with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории development