跳转至

MCP 工具参考

生成来源:Server/ual_mcp/tools.py(TOOL_DEFS 与 TOON 字段顺序)。MCP Server 只读连接 .ual/index.duckdb。

共 4 个工具。批量工具返回 TOON,单资产工具返回 YAML。

ual_search_assets

Multi-funnel hybrid asset retrieval; returns compact TOON candidates + co-occurring bundle.

参数 类型 必填 默认值 说明
query string 否 Natural-language keywords (DuckDB FTS BM25)
asset_class string 否 e.g. AnimMontage, NiagaraSystem, StaticMesh
filters object 否 Hard constraints: skeleton, duration_min/max, min/max_forward_cm, dominant_limb
domain_scope string 否 Directory whitelist, e.g. /Game/Characters/Knight
limit integer 否 8

返回:TOON:section candidates + co_occurring_bundle

实现:Server/ual_mcp/tools.py

ual_inspect_asset

Deep single-asset contract with semantic annotations; returns YAML.

参数 类型 必填 默认值 说明
key string 是 logical_id or asset_path

返回:YAML:完整 AssetSpec(优先读 assets.yaml_cache)

实现:Server/ual_common/yamlspec.py

ual_get_cooccurring_bundle

Co-occurrence graph bundle recommendation; returns TOON.

参数 类型 必填 默认值 说明
asset_path string 是
top_k integer 否 5

返回:TOON:section co_occurring_bundle

实现:Server/ual_mcp/tools.py

ual_find_similar_assets

Deterministic 16-dim fingerprint duplicate detection; returns TOON.

参数 类型 必填 默认值 说明
asset_path string 是
threshold number 否 0.85

返回:TOON:section similar_assets

实现:Server/ual_mcp/tools.py

TOON section 字段顺序

section 字段(顺序固定)
candidates logical_id, duration, forward_cm, strike_window, limb, score
co_occurring_bundle logical_id, asset_class, weight, hint
similar_assets logical_id, asset_class, similarity, shared_class

字段顺序与转义规则见 docs/reference/protocol.md。