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 分