SuperAPI AI 工具集

markmap-viz

数据与分析

查看项目

更新于 10-15 17:21

技能介绍

用途:把 Markdown 或大纲结构转换为可交互的思维导图,适合展示网络与安全等领域的分层信息,输出为可在浏览器中缩放、折叠展开和拖拽的 SVG。

主要能力:提供 5 个工具,需通过 mcp-call 调用。markmap_generate 从 Markdown 生成导图;markmap_from_outline 从大纲条目生成;markmap_get_structure 仅提取结构不渲染;markmap_render_file 从文件渲染并按需保存输出;markmap_customize 支持指定 theme(如 dark)与 color_scheme(如 rainbow)。

使用方式示例: python3 $MCP_CALL "node $MARKMAP_MCP_SCRIPT" markmap_generate '{"markdown_content":"# Network Topology\n## Routers\n### R1 - 10.255.255.1"}' 可用场景包括网络清单、OSPF 拓扑、BGP 拓扑、安全审计结果、VLAN 结构、排障决策树、配置对比、ACI fabric 与 ISE 策略层级。可与 pyats-health-check、pyats-security、pyats-topology、netbox-reconcile 数据配合,并可与 drawio-diagram 搭配使用:markmap 呈现层级视图,Draw.io 呈现拓扑视图。

限制与失败处理:工具调用出现认证或连接错误时,应先检查 MARKMAP_MCP_SCRIPT 是否已设置且有效,而非误判为数据或设备问题。遇到超时、主机不可达或响应异常等工具错误,应直接向用户报告错误信息,不得编造或猜测结果。对确认的只读调用可检查连通性并酌情重试一次;对会改变状态或发送消息的调用,超时不能证明失败,需先核查当前状态或投递状态并保留所需审批与变更门禁,结果未知时不得重复执行。其余细节资料未提供。