Overte Mcp

io.github.sandraschi由 GitHub 帳號 sandraschi 發布v0.2.1更新於 Oct 24, 2026

Overte (open-source Vircadia-lineage metaverse) Model Context Protocol server for domain administ...

已驗證STDIO僅桌面開發者工具媒體與設計

概覽

AI 產生的概覽

針對開源社交 VR 平台 Overte 的 MCP 伺服器，讓助理查詢網域狀態，並在世界中生成或編寫實體腳本。

可以做什麼
透過 40100 連接埠的管理 API 查詢執行中的 Overte 網域伺服器狀態、節點與設定。在世界中生成實體，可設定位置、縮放與類型，並可設為跨重新啟動持續保留。透過 WebSocket 橋接向實體注入 JavaScript 行為腳本。在宿主支援時藉由取樣能力進行多步規劃。附帶的網頁儀表板提供實體、腳本、化身、聊天與日誌頁面。
適用情境
當你執行 Overte 網域，希望助理查看其遙測資料，或在世界中建立與編寫實體腳本，而不必在用戶端手動操作時使用。
執行需求
本機程序，需 Python 3.12+ 與 uv；網頁儀表板需 Bun。Overte 網域伺服器與 Interface 用戶端需另行安裝。生成實體與注入腳本需要執行中的 Interface 並載入橋接腳本；網域狀態只需網域伺服器。
安裝前請注意
生成實體與注入腳本會寫入即時世界，設為持續後還會跨重新啟動保留。注入的 JavaScript 在 Overte 用戶端內執行，只應注入可信腳本。回應會標示為即時或模擬，依賴結果前請先確認該標示。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Overte Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

overte-mcp

[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.

DirectionArtifactsNotes
Hands-inEntity properties (position, scale, type), JS behavior scripts, GLB/FBX/OBJ model URLsVia MCP tool calls or the dashboard's Entities/Scripting pages
Hands-outLive domain-server telemetry, spawned in-world entities, animated/scripted entitiesReal 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):

ToolStatus
overte_domain_statusVerified live (2026-07-30): domain-server /nodes.json + /settings.json on port 40100
overte_bridge_status / overte_bridge_installNew 2026-10-31: bridge mode (agent/interface) and headless install as a persistent script. See STATUS.md for live verification state.
overte_entity_spawnVerified live — in-world entity spawning via WebSocket bridge; permanent=True for cross-restart persistence
overte_script_injectVerified live — in-world JS behavior injection via WebSocket bridge
overte_entity_update / delete / animateLive-only entity lifecycle (move/resize, delete, spin/bob/bounce)
overte_nearby_entities / fixture_spawnLive world search + gripper test fixtures (box/cup/ball/table/chair)
overte_sampling_assistMulti-step planning via ctx.sample() when host supports it
overte_shutdownOrderly self-termination (confirm=True) + POST /api/shutdown

Dashboard pages:

PageRouteFeatures
Dashboard/Domain status, node list, settings viewer
Avatars/avatarsConnected avatar-mixer/agent nodes
Entities/entitiesSpawn form + entity explorer
Scripting/scriptingJS code editor + script injection
Chat/chatSkill-first LLM chat with 4 personalities
Settings/settingsBackend health + LLM provider detection
Tools/toolsDynamic tool discovery + search
Skills/skillsSkill content viewer (markdown)
Logs/logsRing-buffer log viewer with level filter
Inbox/inboxServer events needing attention (search/filter/sort/paginate)
Help/helpDomain setup, hosting + invites, JS API reference

Quick Install

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

powershell
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:

json
{  "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)

powershell
./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

powershell
just lint      # Ruff + Biomejust test      # unit + e2ejust mcpb-pack # validate + pack Claude Desktop bundle

Documentation

Requirements

License

MIT

來源：README.md，提交 1613544

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分