GNS3网络模拟器MCP服务器

# 1. Clone the repository
git clone https://github.com/wael-rd/gns3-mcp-server.git
cd gns3-mcp-server

# 2. Install dependencies (automatic on first run)
python -m pip install -e .

# 3. Add to Gemini CLI
gemini mcp add gns3 "path/to/gns3-mcp-server/run.bat"  # Windows
gemini mcp add gns3 "path/to/gns3-mcp-server/run.sh"   # Linux/Mac

# 4. Test the connection
gemini "List all GNS3 projects"

gemini "Save the current project with a checkpoint"

gemini "Export the project to 'network_lab_backup.zip'"

# AI Conversation - Building a multi-site network
User: "Create a new project called 'Enterprise_WAN' with 3 sites connected via routers"

AI: "I'll create that network for you..."
# Creates project
# Lists available templates
# Adds 3 routers (HQ, Branch1, Branch2), switches, and PCs
# Connects them with proper WAN and LAN links
# Configures IP addressing and OSPF routing
# Starts all devices

User: "Configure OSPF on all routers with area 0"

AI: "Applying OSPF configuration..."
# Uses gns3_apply_config_template for each router
# Configures network statements
# Saves configurations

User: "Add DHCP on the branch routers for local PCs"

AI: "Setting up DHCP pools..."
# Applies DHCP template to branch routers
# Configures appropriate IP ranges

User: "Set up VLANs 10, 20, 30 on my switch for Sales, Engineering, and Management"

AI: "Creating VLANs and configuring ports..."
# Creates VLANs with names
# Configures trunk port to router
# Sets access ports for each department
# Configures inter-VLAN routing on router

User: "Show me the running configuration"

AI: "Here's the current configuration..."
# Uses gns3_get_node_config to retrieve and display config

User: "My network between HQ and Branch1 has connectivity issues"

AI: "Let me diagnose the problem..."
# Runs gns3_validate_topology
# Checks node status
# Starts packet capture on WAN link
# Sends diagnostic commands to routers
# Analyzes routing tables

AI: "Issue found: Interface GigabitEthernet0/1 on HQ router is administratively down"

User: "Fix it please"

AI: "Enabling the interface..."
# Sends console commands: no shutdown
# Verifies connectivity with ping tests

User: "Create a CCNA practice lab with 2 routers, 2 switches, and 4 PCs"

AI: "Building your CCNA lab..."
# Creates project with descriptive name
# Adds devices with proper positioning
# Connects according to typical CCNA topology
# Applies basic configuration (hostnames, interfaces)
# Creates snapshot "Clean_State" for resetting

User: "Configure Router1 as DHCP server for the 192.168.1.0/24 network"

AI: "Configuring DHCP..."
# Applies dhcp_pool template
# Sets up excluded addresses for gateway
# Configures DNS servers

User: "Configure all routers with SSH access, username 'admin', password 'cisco123'"

AI: "Applying SSH configuration to all routers..."
# Uses gns3_list_nodes to find all routers
# Uses gns3_bulk_configure_nodes with SSH template
# Configures domain, crypto keys, VTY lines on each
# Returns status for each device

AI: "SSH configured successfully on 5 routers. 1 failed (Router3 not started)."

# Apply OSPF routing
gns3_apply_config_template(
    node_id="router-id",
    template_name="ospf",
    template_params={
        "process_id": 1,
        "router_id": "1.1.1.1",
        "networks": [
            {"network": "192.168.1.0", "wildcard": "0.0.0.255", "area": 0},
            {"network": "10.0.0.0", "wildcard": "0.0.0.3", "area": 0}
        ]
    },
    save_config=True
)

# Set custom GNS3 server
export GNS3_SERVER_URL="http://192.168.1.100:3080"

# Configure authentication
export GNS3_USERNAME="admin"
export GNS3_PASSWORD="secure_password"

# SSL/TLS settings
export GNS3_VERIFY_SSL="false"

{
  "name": "Enterprise_Router",
  "device_type": "cisco_ios",
  "default_config": {
    "interfaces": [
      {"name": "Gi0/0", "ip": "10.0.0.1/24"},
      {"name": "Gi0/1", "ip": "192.168.1.1/24"}
    ],
    "routing": {
      "protocol": "ospf",
      "area": "0"
    }
  }
}

# Async configuration for high-performance operations
config = {
    "connection_pool_size": 20,
    "request_timeout": 30,
    "retry_attempts": 3,
    "concurrent_operations": 10
}

# Solution 1: Check GNS3 server is running
# Solution 2: Verify server URL
# Solution 3: Check firewall settings

gemini "Ping the GNS3 server to check connectivity"

# Solution: Verify device templates are installed in GNS3
# Use GNS3 GUI to import templates

# Solution: Check username/password in environment variables
export GNS3_USERNAME="your_username"
export GNS3_PASSWORD="your_password"

# Solution: Wait for quota reset or upgrade API plan
# Current rate limit: 1000 requests/hour

export GNS3_MCP_DEBUG=1
gemini "Debug information: Show current GNS3 server status"

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   Gemini CLI    │◄──►│  GNS3 MCP Server │◄──►│  GNS3 Server    │
│                 │    │                  │    │                 │
│ • AI Interface  │    │ • 12 MCP Tools   │    │ • REST API      │
│ • Tool Discovery│    │ • Async Client   │    │ • WebSocket     │
│ • JSON-RPC      │    │ • Error Handling │    │ • Real-time     │
└─────────────────┘    └──────────────────┘    └─────────────────┘

🔐 Authentication Flow
├── Username/Password
├── Token-based Authentication
├── SSL/TLS Encryption
└── Rate Limiting

Q1 2025: Multi-region support
Q2 2025: AI optimization engine
Q3 2025: Advanced analytics dashboard
Q4 2025: Template marketplace launch