Saltar a contenido

MCP Server

El servidor MCP de Topolograph expone la API de Topolograph a través del Model Context Protocol, de modo que los agentes LLM (Claude y otros) pueden consultar topologías, monitorear eventos y calcular rutas en tiempo real — en lenguaje natural, sin necesidad de integraciones de API a medida.

vadims06/topolograph-mcp-server

Ejecutarlo

El servidor MCP está incluido en topolograph-docker — la forma más sencilla de ejecutarlo como parte de la pila completa:

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

Queda disponible en http://localhost:8000/mcp y se conecta automáticamente a la API de Topolograph.

Independiente

pip install -r requirements.txt
export TOPOLOGRAPH_API_BASE="https://your-topolograph-api-url"
export TOPOLOGRAPH_API_TOKEN="your-api-token"   # optional
python mcp-server.py

Endpoint por defecto: http://0.0.0.0:8000/mcp.

Herramientas disponibles

Herramienta Propósito
get_all_graphs Lista los grafos disponibles con filtrado
get_graph_by_time Obtiene un grafo específico por tiempo
get_network_by_graph_time Consulta información de red (por IP, ID de nodo o máscara)
get_graph_status Verifica el estado y la conectividad del grafo
get_network_events Recupera eventos de subida/bajada de red
get_adjacency_events Obtiene eventos de nodo/host y de enlace
get_nodes Consulta los nodos del diagrama
get_edges Consulta los enlaces del diagrama
get_shortest_path Calcula rutas más cortas (con soporte de ruta de respaldo)
upload_graph Sube un nuevo grafo

Qué hace posible

Con estas herramientas conectadas a un agente, puede hacer preguntas como "¿qué grafos están conectados en este momento?", "¿cuál es la ruta entre estas dos IP?" o "¿qué cambió después del último evento de topología?" y obtener respuestas basadas en su IGP real — que es exactamente sobre lo que se construye el agente de IA.


Relacionado: AI Agent · Python SDK · Inicio rápido con Docker