gns3-snapshot-ops

GNS3 Snapshot Operations

Create and manage snapshots of GNS3 project state. Save checkpoints before risky changes and restore to known-good states.

When to Use

• Saving project state before making experimental changes
• Creating checkpoints at key milestones (baseline, after config, etc.)
• Restoring to a previous state after a failed experiment
• Rolling back configuration mistakes
• Comparing different configurations by restoring snapshots
• Training scenarios with repeatable starting points

MCP Server

• Command: python3 -u mcp-servers/gns3-mcp-server/gns3_mcp_server.py (stdio transport)
• Requires: GNS3_URL, GNS3_USER, GNS3_PASSWORD environment variables

Available Tools

Tool	Parameters	What It Does
gns3_list_snapshots	project_id	List all snapshots for a project
gns3_create_snapshot	project_id, name	Create a snapshot of current state
gns3_restore_snapshot	project_id, snapshot_id	Restore project to snapshot state
gns3_delete_snapshot	project_id, snapshot_id	Delete a snapshot

Workflow Examples

Safe Experimentation

# Create baseline before changes
"Create a snapshot called baseline for routing-test"

# Make some changes...
# (configure OSPF, add new links, etc.)

# Something went wrong? Restore to baseline
"Restore routing-test to baseline snapshot"

Milestone Checkpoints

# Save after initial topology setup
"Create a snapshot called topology-complete for routing-test"

# Save after basic configuration
"Create a snapshot called basic-config for routing-test"

# Save after full configuration
"Create a snapshot called full-config for routing-test"

# List all checkpoints
"List snapshots for routing-test"

Training Scenarios

# Create starting point for students
"Create a snapshot called student-starting-point for training-lab"

# After each session, restore to starting point
"Restore training-lab to student-starting-point"