hansjone/netx
1
0
Fork 0
mirror of https://github.com/hansjone/netx.git synced 2026-10-08 22:20:58 +08:00
Code Issues Projects Releases 1 Packages Wiki Activity Actions 4
netx/packages/netx-topology-mcp/README.md
oliver bf0dfd66d8 Add standalone topology MCP with skill, scopes UI, and opt-in live sync. 
Splits canvas/Fabric tools into netx-topology-mcp, documents install and a companion Cursor skill, lets API keys grant ne:write explicitly, and adds optional topology live sync so operators can watch agent drawing without constant polling.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-04 00:16:02 +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（仅已有 fabric_node_ids）, removeTopologyViewNodes, updateTopologyViewPositions, projectTopologyNeighbors
Fabric 只读 getTopologyFabricSummary, listTopologyFabricNodes, searchTopologyFabricNodes, queryTopologyNeighborhood, queryTopologyEdges

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