Infrastructure Topology Viewer MCP Server

Interactive node graph of cloud infrastructure with health status, metrics, and environment switching.

Features

• Interactive Topology Graph - Visualize infrastructure nodes and connections in a dynamic node graph
• Health Status Monitoring - Real-time status indicators (healthy, degraded, down) for all services
• Comprehensive Metrics - Track CPU, memory, active connections, and latency for each node
• Multi-Environment Support - Switch between production, staging, and development environments
• Detailed Node Analytics - View logs, uptime, region, and version information for any infrastructure component
• Traffic Visualization - See traffic flow and latency metrics along connections between services

Installation

npm install @gongrzhe/server-infra-topology-viewer

Usage

As a CLI

npx @gongrzhe/server-infra-topology-viewer

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "infra-topology-viewer": {
      "command": "npx",
      "args": ["-y", "@gongrzhe/server-infra-topology-viewer"]
    }
  }
}

Claude Code Configuration

claude mcp add infra-topology-viewer -- npx -y @gongrzhe/server-infra-topology-viewer

Tools

get-topology

Returns the infrastructure topology for a given environment, including nodes (services) and edges (connections) with health status and metrics.

Parameters:

• environment (optional): Target environment - "production" (default), "staging", or "development"

Returns:

• nodes: Array of infrastructure services with their type, status, and metrics (CPU, memory, connections, latency)
• edges: Array of connections between services showing traffic and latency information
• summary: Overview of service count and health status

get-node-details

Returns detailed information about a specific infrastructure node, including metrics, logs, uptime, region, and version.

Parameters:

• nodeId: The ID of the node to get details for (e.g., "api-1", "db-primary")

Returns:

• node: Detailed node information including:
  • Metrics (CPU, memory, connections, latency)
  • Recent log entries
  • Uptime duration
  • Region location
  • Service version

Example Prompt

Show the production infrastructure topology

License

MIT