Add createTopologyFolder MCP tool for topology regions.

This commit is contained in:
oliver 2026-08-04 17:30:56 +08:00
parent 8991bb31d1
commit 4abb037dce
5 changed files with 78 additions and 13 deletions

View file

@ -19,14 +19,14 @@ disable-model-invocation: false
3. **只动已有 Fabric**:禁止 `managed_ne_ids` / `ume_ne_ids`;禁止臆造 fabric id。
4. **不污染 Fabric**:不能手工建链、不能 populate、不能删 Fabric / 整图。邻居用 `projectTopologyNeighbors`。
5. **写权限**:需要 `ne:write`。tools/list 没有写工具 → 停,让用户用「MCP + 拓扑写」签发 Token。
6. **无 folder 则停**:`createTopologyView` 需要已有 `folder_id`;MCP 不能新建 region。
6. **无区域则先建**:`createTopologyView` 需要 `folder_id`;没有合适区域时用 `createTopologyFolder`(API 会自动建默认 physical 图)。
7. **单画布硬顶 2000**:满了 `truncated` / 触顶 → 新建另一张画布继续;全网五万设备靠多画布切片。
## 推荐流水线(从零画一张图)
```
1 getTopologyTree → folder_id
2 createTopologyView → view_id
1 getTopologyTree → 看有无区域;没有则 createTopologyFolder → folder_id
2 createTopologyView(或用区域自带的 physical 图)→ view_id
3 addTopologyViewNodes(keyword=…, limit) → 看 added / next_offset,循环 offset 直到无更多或满 cap
4 projectTopologyNeighbors → 可选
5 updateTopologyViewPositions(layout=grid|offset|stack, keyword=…) → API 自己筛并摆
@ -39,7 +39,7 @@ disable-model-invocation: false
| 目的 | 工具 |
|------|------|
| 树 / 画布 | `getTopologyTree`, `listTopologyViews`, `getTopologyView`, `createTopologyView` |
| 树 / 区域 / 画布 | `getTopologyTree`, `createTopologyFolder`, `listTopologyViews`, `getTopologyView`, `createTopologyView` |
| 筛选批量加 | `addTopologyViewNodes`(filters + limit/offset) |
| 筛选批量挪 | `updateTopologyViewPositions`(layout + filters) |
| 筛选批量删 | `removeTopologyViewNodes`(filters) |
@ -49,7 +49,7 @@ disable-model-invocation: false
## 对人说清楚
- 网页观看:拓扑页开 **「实时同步」**(默认关)。
- 回报:`view_id`、画布名、`added`/`updated`/`removed`、是否 `truncated`/`next_offset`。
- 回报:`folder_id` / `view_id`、画布名、`added`/`updated`/`removed`、是否 `truncated`/`next_offset`。
## 不要做