mirror of https://github.com/hansjone/netx.git synced 2026-10-09 03:10:46 +08:00

History

oliver af29977878 Stop auto-creating maps on new regions; keep aggregate edges single-width by default.		2026-08-04 19:09:32 +08:00
..
src/netx_topology_mcp	Stop auto-creating maps on new regions; keep aggregate edges single-width by default.	2026-08-04 19:09:32 +08:00
tests	Add createTopologyFolder MCP tool for topology regions.	2026-08-04 17:30:56 +08:00
mcp.json	Add standalone topology MCP with skill, scopes UI, and opt-in live sync.	2026-08-04 00:16:02 +08:00
pyproject.toml	Add standalone topology MCP with skill, scopes UI, and opt-in live sync.	2026-08-04 00:16:02 +08:00
README.md	Add createTopologyFolder MCP tool for topology regions.	2026-08-04 17:30:56 +08:00

netx-topology-mcp

独立的 stdio MCP，只暴露 netx 拓扑画布 / Fabric 能力，与告警/CLI 的 netx-mcp 分开安装，方便 Agent 按需启用。

MCP 宿主  →  stdio  netx_topology_mcp  →  HTTP  NETX_API_URL  →  netx API /v1/topology/*

详细说明 → docs/MCP_TOPOLOGY.md

配套 Skill → .cursor/skills/netx-topology（画图流水线与硬规则）

安装

cd D:\project\chatgpt\netx
pip install -e ./packages/netx-topology-mcp
python -c "import netx_topology_mcp; print('ok')"

GitHub：

pip install "git+https://github.com/hansjone/netx.git#subdirectory=packages/netx-topology-mcp"

复制 mcp.json 到 Cursor / oclaw（server_id=netx-topology），可与 netx 同时存在。

类别	工具
树/区域/画布	`getTopologyTree`, `createTopologyFolder`, `listTopologyViews`, `getTopologyView`, `createTopologyView`
画图	`addTopologyViewNodes` / `remove…` / `update…Positions`（优先筛选，API 自选 id；也可 id 列表）, `projectTopologyNeighbors`
Fabric 只读	`getTopologyFabricSummary`, `listTopologyFabricNodes`, `searchTopologyFabricNodes`, `queryTopologyNeighborhood`, `queryTopologyEdges`

安全约束： MCP 不会创建 Fabric 占位节点、不会写手工链路；画布只能引用已存在的 fabric 节点。