overte-mcp

overte-mcp

ラップ対象

オープンソースのソーシャルVRプラットフォームである**Overte**向けのMCP サーバーです。High Fidelityのコードベースから派生した、C++製のデスクトップクライアント（「Interface」）、ドメインサーバー、エンティティサーバーで構成されています。現在の「Vircadia」とは別物です。詳しい区別と公式リンク（サイト、ドキュメント、コミュニティ）については、docs/WRAPPEE.mdをご覧ください。フリート内のほかの仮想世界向けサーバー（resonite-mcp、vrchat-mcp、godot-mcp、unity3d-mcp、gazebo-mcp）を補完します。

React製のウェブダッシュボードも付属しています。

できること

実行方法：Overte（domain-serverとInterface）は別途インストールするアプリケーションで、同梱されることはありません。overte_domain_statusはdomain-serverだけで動作します（GUIは不要です）。overte_entity_spawnとoverte_script_injectを使うには、scripts/overte-mcp-bridge.jsを読み込んだInterfaceクライアントが起動している必要があります。Overteのentity-serverには通常のHTTPによる「エンティティ作成」エンドポイントがなく、作成にはInterfaceのJavaScript APIのみを使用できるためです。初回セットアップについてはdocs/ONBOARDING.mdをご覧ください。

方向	成果物	備考
取り込み	エンティティのプロパティ（位置、スケール、タイプ）、JS動作スクリプト、GLB/FBX/OBJモデルのURL	MCP ツール呼び出し、またはダッシュボードのEntities／Scriptingページから操作できます
出力	ドメインサーバーのライブテレメトリ、ワールド内に生成されたエンティティ、アニメーション付き／スクリプト付きエンティティ	すべてのレスポンスにsource: "live"またはsource: "simulated"と明記されます。成功したように見せかけることはありません

ツール — 3つのコアツールすべてで、Overte 2026.04.1に対するライブ動作を検証済みです（2026-07-30）。

ツール	状態
overte_domain_status	ライブ動作を検証済み — ポート40100の実際のドメインサーバー/nodes.jsonおよび/settings.json管理API
overte_entity_spawn	ライブ動作を検証済み — WebSocketブリッジ経由でワールド内にエンティティを生成します。permanent=Trueを指定すると再起動後も保持されます
overte_script_inject	ライブ動作を検証済み — WebSocketブリッジ経由でワールド内にJS動作を注入します
overte_sampling_assist	ホストが対応している場合、ctx.sample()を使った複数ステップのプランニング

ダッシュボードのページ：

ページ	ルート	機能
ダッシュボード	/	ドメインの状態、ノード一覧、設定ビューアー
アバター	/avatars	接続中のavatar-mixer／agentノード
エンティティ	/entities	生成フォーム＋エンティティエクスプローラー
スクリプト	/scripting	JSコードエディター＋スクリプト注入
チャット	/chat	4種類のパーソナリティを備えたスキル優先のLLMチャット
設定	/settings	バックエンドの健全性＋LLMプロバイダーの検出
ツール	/tools	動的なツールの検出＋検索
スキル	/skills	スキルコンテンツビューアー（Markdown）
ログ	/logs	レベルフィルター付きリングバッファログビューアー
ヘルプ	/help	ドメインのセットアップ＋JS APIリファレンス

クイックインストール

Claude Desktop（.mcpb）

1. ビルド：just mcpb-pack → dist/overte-mcp.mcpb
2. .mcpbをClaude Desktopにドラッグします（Python 3.12+とPATH上のuvが必要です）。

MCPBを使わずにStdioで実行する場合：uv run overte-mcp。インストール先の詳細：INSTALL.md。

フルスタック（ダッシュボード＋ブリッジ）

./start.ps1

依存関係を同期し、FastAPIバックエンド（11110）とViteダッシュボード（11111）を起動して、ブラウザーを開きます。その後、Overteのdomain-server.exeを起動してInterfaceを開き、ライブでの生成／注入にはscripts/overte-mcp-bridge.jsを読み込んでください。詳しくはdocs/ONBOARDING.mdをご覧ください。

プロンプトの例

• 「自分のOverteドメインの状態は？」
• 「原点に永続的なボックスエンティティを生成して」
• 「そのエンティティにダンススクリプトを追加して」

Lint／テスト

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

ドキュメント

• docs/WRAPPEE.md — Overte の概要、Vircadia との区別、公式リンク
• docs/ARCHITECTURE.md — データフロー、ポート、WebSocket ブリッジ
• INSTALL.md — Overte のセットアップ、MCPB、Claude Desktop の設定
• STATUS.md — 現在の検証状況、残作業
• ASSESSMENT.md — フリート監査の調査結果と改善計画
• PROJECT_PAGE.md — ロードマップとタスクトラッカー
• CHANGELOG.md — リリースノート
• docs/ONBOARDING.md — Overte とブリッジの初回セットアップ
• docs/CONFIGURATION.md — 環境変数、ポート
• docs/DEVELOPMENT.md — 開発環境のセットアップ、コントリビューション
• docs/TOOLS.md — MCP ツールの完全なリファレンス
• docs/TROUBLESHOOTING.md — よくある問題
• llms.txt / llms-full.txt — LLM インデックスと全コーパス
• mcpb/README.md — Claude Desktop バンドルの構成

要件

• uv を使用する Python 3.12 以降
• Bun（ウェブアプリと Biome）
• ライブドメインとブリッジ機能を利用するには、Overte Client + Server を別途インストールしてください

ライセンス

MIT