Communitygithub.com

tc-imba/ue-official-mcp

公式Unreal Engine ModelContextProtocol MCPサーバーのリファレンスドキュメントを、ライブエディタをプローブして再生成・公開します。Epicリリースごとに1つのスキルが存在します。

ue-official-mcp とは?

このスキルは、Unreal Engine 5.8.0に同梱されている公式MCP(ModelContextProtocol)プラグインの操作ルーティングとツールカタログを提供します。UEエディタが動作していることを前提とし、HTTP経由で数十のツールセット/数百のツールを公開します。スキルは`references/`配下に生成されたツールカタログへのインデックスとして機能し、ブループリント、マテリアル、Niagara、アニメーション、シーン/アクター、GAS、UMGなど、主要なタスク領域ごとに適切なツールセットとツールを案内します。すべてのスキーマはUE 5.8.0からキャプチャされており、他のエンジンバージョン(パッチリリースを含む)には対応する`ue-official-mcp-<X.Y.Z>`スキルを使用する必要があります。MCPプラグインはExperimentalであるため、APIやデータ形式はバージョン間で変更される可能性があり、スキルは`describe_toolset`による回復パスを推奨しています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add tc-imba/ue-official-mcp

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

ue-official-mcp-5.8.0 — 適切なUE 5.8.0 MCPツールを選択

公式Unreal Engine 5.8.0 MCPサーバー(ModelContextProtocolプラグイン)の運用ルーティングです。このスキルは決定レイヤーであり、references/配下の生成ツールカタログへのインデックスです。このスキルの全スキーマはUE 5.8.0からキャプチャされています — 他のエンジンバージョン(UE 5.8パッチリリースを含む)では、MCPプラグインはExperimentalでありリリース間で差異が生じるため、対応するue-official-mcp-<X.Y.Z>スキルを使用してください。

AllToolsetsが有効な場合、サーバーはHTTP(ストリーミング可能、デフォルトhttp://127.0.0.1:8000/mcp)経由で数十のツールセット/数百のツールを公開します。エディタが起動している必要があり、ゲームスレッド上で直列に実行されるため、重複した呼び出しは行わないでください。正確なライブカウントと、このリファレンスが生成されたスナップショット日付については、references/index.mdを参照してください。

使用するタイミング

公式MCPのエディタ自動化呼び出しの前に — タスクに適したツールセット/ツールを選択し、対応するreferences/*.mdを開いてツール名を確認し、references/toolsets/配下のツールセットごとの生ファイルで完全な入出力JSONスキーマを確認します。そのスキーマから直接呼び出します — describe_toolsetによる事前確認は不要です。

呼び出し方

ツール検索がオンになっているため、tools/listには3つのメタツールのみ表示されます。Claude Codeセッションでは、これらは**mcp__<サーバーキー>__***として表示されます。<サーバーキー>はMCPクライアントの.mcp.jsonでサーバーに付けられた名前です(Epicのセットアップ例ではunreal-mcp → mcp__unreal-mcp__*)。3つのメタツール:

  1. list_toolsets — 有効なツールセットの名前と概要。発見目的では呼び出さないでください: 以下のルーティングテーブルを使用してください。
  2. describe_toolset(toolset_name) — 1つのツールセット内のツール(名前とスキーマ)。呼び出すのは、call_toolがスキーマ形式のエラー(不明なフィールド、型違い)を返した場合の回復パスとしてのみ、ライブのスキーマがファイルからずれていないかを確認するためです。
  3. call_tool(name, arguments) — ツールを実行し、同じターンで結果を返します。

フロー:以下のドメインを特定 → そのreferences/*.mdを開いてツールセット名+ツール名を確認 → 生のreferences/toolsets/<名前>.mdを開いて完全な入力スキーマを確認 → call_toolを直接実行。呼び出しがスキーマ形式のエラーを返した場合、describe_toolsetを再度実行してずれを特定し、再試行します — ずれを報告してメンテナーがsyncを再実行できるようにすることを検討してください。

ルーティング — タスクドメイン → リファレンス

タスクドメインリファレンス
Blueprintグラフとロジック(グラフDSLを含む)references/blueprint.md
マテリアル、マテリアルインスタンス、テクスチャreferences/material.md
Niagara(システム/エミッター/モジュール/コンポーネント)references/niagara.md
アニメーション、Control Rig、Sequencerreferences/animation-sequencer.md
スタティック/スケルタルメッシュ、プリミティブ、PCGreferences/mesh-geometry.md
シーン/レベル、アクター、アセット、オブジェクトreferences/scene-actor.md
GAS(キュー、属性セット、ASC検査)、GameplayTagsreferences/gas.md
UMG、StateTree、BehaviorTree、WorldConditions、Conversationreferences/ui-state.md
データ/カーブ/文字列テーブル、データアセット、DataRegistryreferences/data-tables.md
エディタ制御(コンソール/PIE/ビューポート)、ログ、自動化テスト、Slate検査references/editor-automation.md
GameFeatures、プラグイン、Dataflow、物理、SemanticSearch、AgentSkillreferences/project-misc.md

各ドメインファイルは、ツールセットごとの生カタログ(references/toolsets/)にリンクしており、describe_toolsetからのすべてのツールの完全な入出力JSONスキーマがそのまま含まれています。

注意点

  • Experimental — APIやデータ形式はエンジンバージョン間で変更される可能性があります。リファレンスはsyncが最後に実行された時点のスナップショットです(日付はreferences/index.mdを参照)。スキーマは楽観的に信頼し、call_toolがスキーマ形式のエラーを返した場合のみdescribe_toolsetで回復してください。
  • エディタが起動している必要があります。呼び出しは直列 — 一度に1つずつ。
  • AgentSkillToolset.CreateSkill/UpdateSkillは明示的なユーザー許可が必要です(ツール自体がそう述べています)— 促されずにAgentSkillを作成しないでください。
  • このリファレンスの再生成: uv run ue-mcp-skills sync --engine <X.Y.Z> --launchを実行します(ライブエディタをプローブし、references/配下のすべてを書き換えます)。--launchなしの場合は、--endpointですでに起動しているエディタを指定します。生成されたファイルにはスタンプヘッダーが含まれます — 手動で編集しないでください。代わりにscripts/toolset_map.yamlのドメイングループを編集してください。

関連スキル