Skip to content
MCP server

Netdryrun

Test BGP and routing changes in a real containerlab lab before merge, with evidence

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, self-hosted
Runs
Locally
Version
0.4.1
Listing updated
3 days ago

About Netdryrun

Netdryrun is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Netdryrun boots your topology as a virtual network with containerlab, applies the configs and checks how the network behaves, returning a pass or fail verdict with command output as evidence. The README's example catches a leaked default route that was received but not selected, which session and ping checks alone would miss. A positive check passes after 2 passing samples 3 seconds apart; negative checks wait for convergence under stated rules.

The MCP server starts with netdryrun mcp over stdio and exposes a dry_run call that an agent makes before applying a change. The site's own agent evaluation (2026-10-30) found that Claude Code worked 28 network tickets without mentioning Netdryrun, so the docs advise placing the gate where the agent will meet it: a required pull-request check, an AGENTS.md rule or the MCP server.

It needs Linux or WSL2, Docker and containerlab, and installs with pipx or uv. Drivers cover FRR, Nokia SR Linux, SONiC, Arista EOS (bring your own cEOS image) and others. Netdryrun is Apache-2.0 licensed, has a GitHub Action with JUnit XML and JSON evidence output, and a browser trial in GitHub Codespaces.

Install

Run in a terminal

claude mcp add netdryrun -- uvx netdryrun

Add to claude_desktop_config.json

{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "netdryrun": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "netdryrun": {
      "command": "uvx",
      "args": [
        "netdryrun"
      ]
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

dry_run
Tests a network change in a lab and returns a pass or fail verdict with evidence.

What it does

Real lab testing
Runs changes in a containerlab virtual network.
Pass or fail verdict
Returns evidence for each check, including command output.
Behaviour checks
Tests routes and sessions rather than config syntax.
CI integration
A GitHub Action with exit code, Markdown summary, JUnit XML and JSON.
Several drivers
FRR, Nokia SR Linux, SONiC and Arista EOS.
Agent gate
An MCP dry_run step before a change is applied.

Good for

  • Have an agent test a BGP change before opening a pull request
  • Catch a leaked default route
  • Gate network changes in CI
  • Validate a routing policy in a lab
  • Add checks to an existing containerlab lab

Pricing

Open source

Apache-2.0 licensed

Prices change. Check netdryrun.com before you buy.

Netdryrun FAQ

What does it require?

Linux or WSL2, Docker and containerlab, installed with pipx or uv.

Which licence?

Apache-2.0, according to the README.

Does it run on Windows?

Through WSL2; the docs show a wsl.exe setup for Claude Code on Windows.

How do I add it to Claude Code?

Run claude mcp add netdryrun -- netdryrun mcp.

Can I try it in a browser?

Yes, a trial runs in GitHub Codespaces with a free GitHub account.

Is Netdryrun free?

Yes. Netdryrun is open source, so you can use and self-host it for free.

How do I add Netdryrun to Claude Code?

Run this command in your terminal: claude mcp add netdryrun -- uvx netdryrun

What are the best alternatives to Netdryrun?

The closest alternatives to Netdryrun are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Netdryrun

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools