tc-imba/ue-official-mcp

ue-official-mcp-5.8.0 — elige la herramienta MCP correcta de UE 5.8.0

Enrutamiento operativo para el servidor MCP oficial de Unreal Engine 5.8.0 (el plugin ModelContextProtocol). Esta skill es la capa de decisión + un índice del catálogo de herramientas generado en references/. Todos los esquemas en esta skill se capturaron de UE 5.8.0 — para otras versiones del motor (incluidas las versiones de parche de UE 5.8) usa la skill coincidente ue-official-mcp-<X.Y.Z>, ya que el plugin MCP es Experimental y presenta desviaciones entre versiones.

Con AllToolsets habilitado, el servidor expone docenas de conjuntos de herramientas / cientos de herramientas a través de HTTP (transmisible, por defecto http://127.0.0.1:8000/mcp). Requiere que el editor esté ejecutándose y funciona en serie en el hilo del juego — nunca realices llamadas superpuestas. Para los recuentos exactos en vivo y la fecha de la instantánea con la que se generó esta referencia, consulta references/index.md.

Cuándo usarla

Antes de cualquier llamada de automatización del editor oficial-MCP — para elegir qué conjunto de herramientas/herramienta se ajusta a la tarea, luego lee el references/*.md coincidente para los nombres de las herramientas y (en el archivo sin formato por conjunto de herramientas en references/toolsets/) los esquemas JSON completos de entrada/salida. Llama directamente desde esos esquemas — no se necesita describe_toolset previo.

Cómo llamar

La búsqueda de herramientas está activada, por lo que tools/list muestra solo 3 meta-herramientas. En una sesión de Claude Code aparecen como mcp__<clave-del-servidor>__*, donde <clave-del-servidor> es el nombre que se le da al servidor en .mcp.json del cliente MCP (el ejemplo de configuración de Epic usa unreal-mcp → mcp__unreal-mcp__*). Las tres meta-herramientas:

1. list_toolsets — nombres + resúmenes de los conjuntos de herramientas habilitados. No la llames para descubrimiento: usa la tabla de enrutamiento a continuación.
2. describe_toolset(nombre_del_conjunto) — las herramientas (nombres + esquemas) en un conjunto de herramientas. Solo llámala como ruta de recuperación cuando un call_tool devuelva un error con forma de esquema (campo faltante/desconocido, tipo incorrecto), para comprobar si el esquema en vivo se ha desviado del archivo.
3. call_tool(nombre, argumentos) — despacha una herramienta; el resultado regresa en el mismo turno.

Flujo: identifica el dominio a continuación → abre su references/*.md para el nombre del conjunto de herramientas + herramienta → abre el archivo sin formato references/toolsets/<Nombre>.md para el esquema de entrada completo → call_tool directamente. Si la llamada devuelve un error con forma de esquema, vuelve a describe_toolset para identificar la desviación, luego reintenta — y considera marcar la desviación para que un mantenedor pueda volver a sync.

Enrutamiento — dominio de tarea → referencia

Dominio de tarea	Referencia
Gráficos de Blueprint y lógica (incl. DSL de gráficos)	references/blueprint.md
Materiales, instancias de material, texturas	references/material.md
Niagara (sistema/emisor/módulo/componente)	references/niagara.md
Animación, Control Rig, Sequencer	references/animation-sequencer.md
Malla estática/esquelética, primitivas, PCG	references/mesh-geometry.md
Escena/nivel, actores, assets, objetos	references/scene-actor.md
GAS (señales, conjuntos de atributos, inspección ASC), GameplayTags	references/gas.md
UMG, StateTree, BehaviorTree, WorldConditions, Conversation	references/ui-state.md
Tablas de datos/Curvas/Cadenas, Data assets, DataRegistry	references/data-tables.md
Control del editor (consola/PIE/viewport), registros, pruebas de automatización, inspección Slate	references/editor-automation.md
GameFeatures, Plugins, Dataflow, Física, SemanticSearch, AgentSkill	references/project-misc.md

Cada archivo de dominio enlaza al catálogo sin formato por conjunto de herramientas (references/toolsets/), que contiene el esquema JSON completo de entrada/salida de cada herramienta, tomado textualmente de describe_toolset.

Advertencias

• Experimental — las API/los formatos de datos pueden cambiar entre versiones del motor. La referencia es una instantánea de cuando sync se ejecutó por última vez (consulta references/index.md para la fecha). Confía en el esquema de forma optimista; recupérate mediante describe_toolset solo si un call_tool devuelve un error con forma de esquema.
• El editor debe estar ejecutándose; las llamadas son seriales — una a la vez.
• AgentSkillToolset.CreateSkill/UpdateSkill requieren permiso explícito del usuario (las herramientas lo indican) — no crees AgentSkills sin que te lo pidan.
• Regenerar esta referencia: ejecuta uv run ue-mcp-skills sync --engine <X.Y.Z> --launch (sondea un editor en vivo y reescribe todo bajo references/). Sin --launch, apunta --endpoint a un editor ya en ejecución. Los archivos generados llevan un sello de encabezado — no los edites manualmente; edita la agrupación de dominios en scripts/toolset_map.yaml en su lugar.