GNS3 Link Management
Create and manage links between node interfaces in GNS3 projects. Build network topologies by connecting devices and isolate nodes for testing.
When to Use
- Connecting two network devices together
- Building out a network topology
- Viewing existing connections in a lab
- Removing links between devices
- Isolating a node without deleting its links
- Re-enabling links after isolation testing
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_links |
project_id |
List all links with connected nodes and interfaces |
gns3_create_link |
project_id, node1, port1, node2, port2 |
Create a link between two interfaces |
gns3_delete_link |
project_id, link_id |
Delete a link |
gns3_isolate_node |
project_id, node_id, isolate |
Disable/enable all links to a node |
Interface Name Formats
The tools support multiple interface naming conventions:
| Format |
Example |
Adapter |
Port |
| eth# |
eth0, eth1 |
0 |
0, 1 |
| Ethernet# |
Ethernet0 |
0 |
0 |
| Gi#/# |
Gi0/0, Gi0/1 |
0 |
0, 1 |
| GigabitEthernet#/# |
GigabitEthernet0/0 |
0 |
0 |
| Fa#/# |
Fa0/0, Fa0/1 |
0 |
0, 1 |
| e# |
e0, e1 |
0 |
0, 1 |
| port# |
port0, port1 |
0 |
0, 1 |
| #/# |
0/0, 0/1 |
0 |
0, 1 |
Workflow Examples
Build a Topology
# Connect router to switch
"Connect router1 Gi0/0 to switch1 eth0 in routing-test"
# Connect switch to another router
"Connect switch1 eth1 to router2 Gi0/0 in routing-test"
# Connect hosts to switch
"Connect host1 eth0 to switch1 eth2 in routing-test"
View Topology
# List all connections
"List all links in routing-test"
Isolate for Testing
# Isolate a node (disable all its links)
"Isolate router1 in routing-test"
# Test behavior with router1 disconnected...
# Re-enable links
"Unisolate router1 in routing-test"
Clean Up
# Remove a specific link
"Delete the link between router1 and switch1 in routing-test"
Integration with Other Skills
- gns3-project-lifecycle: Create project first
- gns3-node-operations: Add nodes before connecting them
- gns3-packet-capture: Capture traffic on links
Error Handling
| Error Code |
Meaning |
Resolution |
| GNS3_NOT_FOUND |
Node or link doesn't exist |
Check names/IDs |
| GNS3_CONFLICT |
Interface already connected |
Check existing links first |
| GNS3_VALIDATION |
Invalid interface format |
Use supported naming conventions |
Notes
- Links can only be created between existing nodes
- Each interface can only have one link
- Isolating a node disables links without deleting them
- Link IDs are UUIDs - use
gns3_list_links to find them
- All operations logged to GAIT audit trail
1---
2name: gns3-link-management
3description: "Manage GNS3 links - connect/disconnect node interfaces, isolate nodes"
4license: Apache-2.0
5user-invocable: true
6metadata:
7 source: https://skillmd.com/skills/gabrielmoreira/gns3-link-management
8 openclaw:
9 requires:
10 bins: ["python3"]
11 env: ["GNS3_URL", "GNS3_USER", "GNS3_PASSWORD"]
12---
13
14# GNS3 Link Management
15
16Create and manage links between node interfaces in GNS3 projects. Build network topologies by connecting devices and isolate nodes for testing.
17
18## When to Use
19
20- Connecting two network devices together
21- Building out a network topology
22- Viewing existing connections in a lab
23- Removing links between devices
24- Isolating a node without deleting its links
25- Re-enabling links after isolation testing
26
27## MCP Server
28
29- **Command**: `python3 -u mcp-servers/gns3-mcp-server/gns3_mcp_server.py` (stdio transport)
30- **Requires**: `GNS3_URL`, `GNS3_USER`, `GNS3_PASSWORD` environment variables
31
32## Available Tools
33
34| Tool | Parameters | What It Does |
35|------|------------|--------------|
36| `gns3_list_links` | project_id | List all links with connected nodes and interfaces |
37| `gns3_create_link` | project_id, node1, port1, node2, port2 | Create a link between two interfaces |
38| `gns3_delete_link` | project_id, link_id | Delete a link |
39| `gns3_isolate_node` | project_id, node_id, isolate | Disable/enable all links to a node |
40
41## Interface Name Formats
42
43The tools support multiple interface naming conventions:
44
45| Format | Example | Adapter | Port |
46|--------|---------|---------|------|
47| eth# | eth0, eth1 | 0 | 0, 1 |
48| Ethernet# | Ethernet0 | 0 | 0 |
49| Gi#/# | Gi0/0, Gi0/1 | 0 | 0, 1 |
50| GigabitEthernet#/# | GigabitEthernet0/0 | 0 | 0 |
51| Fa#/# | Fa0/0, Fa0/1 | 0 | 0, 1 |
52| e# | e0, e1 | 0 | 0, 1 |
53| port# | port0, port1 | 0 | 0, 1 |
54| #/# | 0/0, 0/1 | 0 | 0, 1 |
55
56## Workflow Examples
57
58### Build a Topology
59
60```bash
61# Connect router to switch
62"Connect router1 Gi0/0 to switch1 eth0 in routing-test"
63
64# Connect switch to another router
65"Connect switch1 eth1 to router2 Gi0/0 in routing-test"
66
67# Connect hosts to switch
68"Connect host1 eth0 to switch1 eth2 in routing-test"
69```
70
71### View Topology
72
73```bash
74# List all connections
75"List all links in routing-test"
76```
77
78### Isolate for Testing
79
80```bash
81# Isolate a node (disable all its links)
82"Isolate router1 in routing-test"
83
84# Test behavior with router1 disconnected...
85
86# Re-enable links
87"Unisolate router1 in routing-test"
88```
89
90### Clean Up
91
92```bash
93# Remove a specific link
94"Delete the link between router1 and switch1 in routing-test"
95```
96
97## Integration with Other Skills
98
99- **gns3-project-lifecycle**: Create project first
100- **gns3-node-operations**: Add nodes before connecting them
101- **gns3-packet-capture**: Capture traffic on links
102
103## Error Handling
104
105| Error Code | Meaning | Resolution |
106|------------|---------|------------|
107| GNS3_NOT_FOUND | Node or link doesn't exist | Check names/IDs |
108| GNS3_CONFLICT | Interface already connected | Check existing links first |
109| GNS3_VALIDATION | Invalid interface format | Use supported naming conventions |
110
111## Notes
112
113- Links can only be created between existing nodes
114- Each interface can only have one link
115- Isolating a node disables links without deleting them
116- Link IDs are UUIDs - use `gns3_list_links` to find them
117- All operations logged to GAIT audit trail