Topolograph MCP

by vadims06

Not rated
GitHub

About

A MCP server that enables LLMs to interact with OSPF and IS-IS protocols and analyze network topologies, query network events, and perform path calculations for OSPF and IS-IS protocols.

Details

Author
vadims06
Categories
Other, Infrastructure

Setup

Install Topolograph MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/vadims06/topolograph-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

A Model Context Protocol (MCP) server that provides access to Topolograph API for OSPF/IS-IS network analysis.

This MCP server enables AI agents to interact with Topolograph API to analyze network topologies, monitor events, and perform path calculations for OSPF and IS-IS protocols. MCP (Model Context Protocol) is essential for connecting Large Language Models (LLMs) to network infrastructure, allowing AI agents to query and analyze network data in real-time.

This MCP server is included in thetopolograph-dockerrepository and is available via the provideddocker-compose.ymlfile.

- Graph Management: Retrieve and upload network graphs
- Network Analysis: Query network information by IP, node ID, or network mask
- Event Monitoring: Track network and adjacency events with time filtering
- Path Calculation: Calculate shortest paths between nodes with backup path support
- Status Monitoring: Check graph connectivity and health status
- Node/Edge Queries: Retrieve detailed node and edge information from diagrams

export TOPOLOGRAPH_API_BASE="https://your-topolograph-api-url"
export TOPOLOGRAPH_API_TOKEN="your-api-token"

The server runs onhttp://0.0.0.0:8000/mcpby default.

This MCP server is included in thetopolograph-dockerrepository. To use it as part of the complete Topolograph stack:

git clone https://github.com/Vadims06/topolograph-docker.git cd topolograph-docker docker-compose pull docker-compose up -d

The MCP server will be available athttp://localhost:8000/mcpand automatically connects to the Flask API.

- get_all_graphs: List available graphs with filtering options
- get_graph_by_time: Fetch specific graph by time
- get_network_by_graph_time: Query network information
- get_graph_status: Check graph health and connectivity
- get_network_events: Retrieve network up/down events
- get_adjacency_events: Get node/host and link events
- get_events_timeline: Node/host events grouped into time waves for incident narration
- get_nodes: Query diagram nodes (filter by role flags: ABR/ASBR, IS-IS overload/attached)
- get_edges: Query diagram edges (include=
["lsp_left_bw", "lsps", "is_te_link", "edge_key"]for MPLS TE fields)
- get_shortest_path: Calculate the shortest path between two nodes (with_lsps=trueto account for autoroute-enabled MPLS-TE tunnels)
- get_edge_failure_reaction: Predict whole-network impact if one or more links go down
- upload_graph: Upload new graphs to the API
- get_lsps/add_lsp/update_lsp/delete_lsp: CRUD for MPLS TE LSP tunnels (filters:status,via_node,via_edge,via_edge_key)
- get_cspf_path: Constrained-shortest-path (CSPF) feasibility check between two nodes, without creating a tunnel

get_events_timelinegroups node/host up/down events into chronologicalwaves, each labelled with apattern(outage/flap/up). For the full field reference and thepattern↔ graph-status mapping, see the docs:

Model Context Protocol server for secure AsusWRT router administration via SSH. Provides 42+ read-only monitoring tools and guarded mutation tools for managing AsusWRT/Merlin routers.

Manage your Pi-hole v6 instance with 55 tools covering DNS blocking, domain management, query analysis, statistics, DHCP, and system administration.

A server that allows MCP clients to use Suricata for network traffic analysis.

MCP access to cluster-wide L4 and L7 network traffic, packets, APIs, and complete payloads.

Digi Remote Manager MCP allows users to connect Ai Agents to their Digi Remote Manager account for analyzing fleet data and help with troubleshooting.

Retrieves essential network information from devices using gNMI and OpenConfig models.

Access Grafana resources like dashboards, datasources, Prometheus, Loki, and alerts.

Access and manage Grafana resources, including dashboards, datasources, Prometheus, Loki, and alerting.

MCP server for Grafana — manage dashboards, datasources, alerts, folders, and annotations over stdio

Interact with HAProxy's runtime API for administration, monitoring, and traffic analysis.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.