netx/packages/netx-topology-mcp/README.md
oliver 2d92dde8e5 Add filter-based topology bulk writes and refine API key scopes UX.
Filter add/layout/remove keeps MCP payloads small; tokens default MCP scopes and edit them in a modal with a compact help tip.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 07:39:14 +08:00

1.5 KiB
Raw Blame History

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 同时存在。

工具(13)

类别 工具
树/画布 getTopologyTree, listTopologyViews, getTopologyView, createTopologyView
画图 addTopologyViewNodes / remove… / update…Positions(优先筛选,API 自选 id;也可 id 列表), projectTopologyNeighbors
Fabric 只读 getTopologyFabricSummary, listTopologyFabricNodes, searchTopologyFabricNodes, queryTopologyNeighborhood, queryTopologyEdges

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