GNS3 Network Simulator MCP Server

Get GNS3 server version and information. Returns server version, supported features, and system information.

List all available compute servers (local, VMs, remote). Shows compute ID, name, protocol, host, port, and status.

List all projects on the GNS3 server with detailed status. Shows project name, ID, node/link counts, and status.

Create a new GNS3 project.

Args: name: Project name auto_close: Automatically close when server stops auto_open: Automatically open when server starts auto_start: Automatically start all nodes when opened path: Custom path for project files

Get detailed information about a specific project. Returns complete project configuration and statistics.

Update project settings. Only specified parameters will be updated.

Open an existing GNS3 project for editing.

Close an open project. All nodes will be stopped.

Permanently delete a project and all its files. WARNING: This action cannot be undone!

Duplicate an existing project with a new name. Creates an exact copy of the project including all nodes and configurations.

List all nodes (devices) in a project. Shows node name, type, status, console port, and position.

Add a network device/node to a project using a template.

Args: project_id: ID of the project node_name: Name for the new node template_id: Template ID (use gns3_list_templates to get available templates) x, y: Position coordinates on the canvas compute_id: Compute server ID (default: "local")

Get detailed information about a specific node. Returns complete node configuration including ports and properties.

Update node settings and properties.

Args: name: New node name x, y: New position coordinates properties: Device-specific properties (RAM, CPU, interfaces, etc.)

Delete a node from the project. All links connected to this node will also be deleted.

Start a specific node.

Stop a specific node.

Suspend a node (pause execution, save state).

Reload a node (restart without stopping).

Duplicate a node with the same configuration. The duplicate will be placed at the specified offset from the original.

Start all nodes in a project.

Stop all nodes in a project.

List all links (connections) in a project. Shows link endpoints, ports, and status.

Create a link between two nodes.

Args: node_a_id, node_b_id: Node IDs to connect adapter_a, port_a: Adapter and port number on node A adapter_b, port_b: Adapter and port number on node B

Delete a link between nodes.

Get complete network topology for a project. Returns all nodes, links, and project information in one call.

Send commands to a node's console via Telnet.

Args: commands: List of commands to execute wait_for_boot: Wait for device to boot before sending commands boot_timeout: Maximum time to wait for boot (seconds) enter_config_mode: Automatically enter config mode (Cisco) save_config: Save configuration after commands (Cisco) enable_password: Enable password if required

Get device configuration via console.

Args: config_type: "running" or "startup" (Cisco-style devices)

Apply a pre-built configuration template to a device.

Supported templates:

• "basic_router": Basic router setup (hostname, domain)

• "interface": Configure interface with IP

• "ospf": Configure OSPF routing

• "eigrp": Configure EIGRP routing

• "bgp": Configure BGP routing

• "static_route": Add static route

• "vlan": Create VLAN

• "trunk_port": Configure trunk port

• "access_port": Configure access port

• "dhcp_pool": Configure DHCP server

• "nat_overload": Configure NAT/PAT

• "ssh": Configure SSH access

Args: template_name: Name of configuration template template_params: Parameters for the template (varies by template) save_config: Save configuration after applying

List all available device templates. Templates are used to create new nodes quickly.

List all available appliances. Appliances are pre-configured device definitions that can be installed.

List all snapshots for a project.

Create a snapshot (backup) of a project. Captures current state of all nodes and configuration.

Restore a project from a snapshot. WARNING: Current project state will be lost!

Delete a snapshot permanently.

Start packet capture on a link. Captured packets can be analyzed with Wireshark.

Args: capture_file_name: Name for the capture file (without .pcap extension) data_link_type: Data link layer type (default: Ethernet)

Stop packet capture on a link.

Add text annotation to the topology. Useful for documenting networks and adding labels.

Add a shape (rectangle or ellipse) to the topology.

Args: shape_type: "rectangle" or "ellipse" color: Border color (hex format) fill_color: Fill color (hex format, optional)

Get idle-pc values for Dynamips routers to reduce CPU usage. Only works with Dynamips/IOS routers.

Args: auto_compute: Automatically compute best idle-pc value

Configure multiple nodes in one operation.

Args: configurations: List of dicts with keys: - node_id: Node to configure - commands: List of commands to send - save_config: Whether to save (optional, default False)

Validate network topology for common issues. Checks for disconnected nodes, missing links, and configuration problems.