create_lab_network

Add a network (bridge, cloud, NAT) to an EVE-NG lab topology with configurable positioning for network emulation setups.

Instructions

Create a network in a lab.

This tool creates a new network (cloud, bridge, NAT, etc.) in the lab with the specified type and positioning.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`arguments`	Yes

Implementation Reference

eveng_mcp_server/tools/network_management.py:159-210 (handler)

The main handler function for the 'create_lab_network' tool. It handles input validation, EVE-NG connection check, creates the network using eveng_client.add_lab_network, and returns formatted TextContent responses.

@mcp.tool()
async def create_lab_network(arguments: CreateNetworkArgs) -> list[TextContent]:
    """
    Create a network in a lab.

    This tool creates a new network (cloud, bridge, NAT, etc.) in the lab
    with the specified type and positioning.
    """
    try:
        logger.info(f"Creating network in lab: {arguments.lab_path}")

        if not eveng_client.is_connected:
            return [TextContent(
                type="text",
                text="Not connected to EVE-NG server. Use connect_eveng_server tool first."
            )]

        # Create network
        result = await eveng_client.add_lab_network(
            arguments.lab_path,
            arguments.network_type,
            name=arguments.name,
            left=arguments.left,
            top=arguments.top,
            visibility=1  # Make network visible by default
        )

        if result.get('status') == 'success':
            net_id = result.get('data', {}).get('id', 'Unknown')
            return [TextContent(
                type="text",
                text=f"Successfully created network in lab!\n\n"
                     f"Lab: {arguments.lab_path}\n"
                     f"Network Type: {arguments.network_type}\n"
                     f"Network ID: {net_id}\n"
                     f"Name: {arguments.name or f'Network{net_id}'}\n"
                     f"Position: ({arguments.left}%, {arguments.top}%)\n\n"
                     f"Network created successfully. You can now connect nodes to it."
            )]
        else:
            return [TextContent(
                type="text",
                text=f"Failed to create network: {result.get('message', 'Unknown error')}"
            )]

    except Exception as e:
        logger.error(f"Failed to create network: {e}")
        return [TextContent(
            type="text",
            text=f"Failed to create network: {str(e)}"
        )]

eveng_mcp_server/tools/network_management.py:24-31 (schema)

Pydantic model defining the input schema (arguments) for the create_lab_network tool.

class CreateNetworkArgs(BaseModel):
    """Arguments for create_network tool."""
    lab_path: str = Field(description="Full path to the lab (e.g., /lab_name.unl)")
    network_type: str = Field(description="Network type (bridge, cloud, nat, etc.)")
    name: str = Field(default="", description="Network name (optional)")
    left: int = Field(default=50, description="Position from left (percentage, 0-100)")
    top: int = Field(default=50, description="Position from top (percentage, 0-100)")

eveng_mcp_server/tools/__init__.py:27-28 (registration)
Registration of network management tools, including create_lab_network, by calling register_network_tools during the overall tools registration process.
```
# Network management tools
register_network_tools(mcp, eveng_client)
```
eveng_mcp_server/server.py:53-53 (registration)
Top-level registration call in the server initialization that triggers the registration of all tools, including create_lab_network.
```
register_tools(self.mcp, self.eveng_client)
```

EVE-NG MCP Server