graph TB
    subgraph "AI Layer"
        Claude["Claude Desktop / MCP Client"]
    end

    subgraph "NetPulse MCP Server"
        Server["server.py<br/>FastMCP"]
        Resources["Resources<br/>6 data endpoints"]
        Tools["Tools<br/>6 diagnostic actions"]
        Prompts["Prompts<br/>3 workflow templates"]
        Sim["Network Simulator<br/>7 virtual devices"]
        Metrics["Prometheus Exporter<br/>/metrics"]
    end

    subgraph "Observability Stack"
        Prom["Prometheus"]
        Graf["Grafana"]
    end

    Claude <-->|MCP Protocol| Server
    Server --> Resources
    Server --> Tools
    Server --> Prompts
    Resources --> Sim
    Tools --> Sim
    Sim --> Metrics
    Metrics --> Prom
    Prom --> Graf

    style Claude fill:#6B48FF,color:#fff
    style Server fill:#0EA5E9,color:#fff
    style Sim fill:#10B981,color:#fff
    style Graf fill:#F59E0B,color:#fff

git clone https://github.com/yourusername/netpulse.git
cd netpulse

docker compose up -d

{
  "mcpServers": {
    "netpulse": {
      "command": "python",
      "args": ["-m", "netpulse.server"],
      "cwd": "/path/to/netpulse"
    }
  }
}

{
  "mcpServers": {
    "netpulse": {
      "url": "http://localhost:8080/sse"
    }
  }
}

# Take down the WAN link
python -m netpulse.simulators.fault_injector --scenario link_down

# Spike CPU on the core router
python -m netpulse.simulators.fault_injector --scenario cpu_spike

# Simulate interface flapping
python -m netpulse.simulators.fault_injector --scenario interface_flap

# Take down a device
python -m netpulse.simulators.fault_injector --scenario device_down

# Saturate bandwidth
python -m netpulse.simulators.fault_injector --scenario bandwidth_saturation

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows

# Install with dev dependencies
pip install -e ".[dev]"

# Run the server locally (stdio mode)
python -m netpulse.server

pytest --cov=netpulse --cov-report=term-missing

# Linting
ruff check src/ tests/

# Type checking
mypy src/netpulse/

          ┌─────────────┐          ┌─────────────┐
          │ core-rtr-01  │◄────────►│ core-rtr-02  │
          │  10.0.0.1    │ 10Gbps  │  10.0.0.2    │
          │  Data Ctr A  │backbone │  Data Ctr B  │
          └──┬──────┬────┘          └──────┬───────┘
             │      │                      │
        10G  │      │ 100M            10G  │
             │      │                      │
     ┌───────┴──┐   │              ┌───────┴──┐
     │dist-sw-01│   │              │dist-sw-02│
     │ 10.0.1.1 │   │              │ 10.0.1.2 │
     └─────┬────┘   │              └──────────┘
           │        │
      1G   │        │
           │        │
     ┌─────┴────┐   │         ┌───────────┐
     │edge-fw-01│   └────────►│ wan-rtr-01 │
     │ 10.0.2.1 │     WAN    │  10.0.4.1  │
     └──────────┘             └──────┬─────┘
                                     │ 1G
                              ┌──────┴──────┐
                              │access-sw-01 │
                              │  10.0.3.1   │
                              │ Branch Off 1│
                              └─────────────┘