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。