EVE-NG MCP Server

Instructions

Implementation Reference

• eveng_mcp_server/tools/node_management.py:402-439 (handler)

  MCP tool handler that starts all nodes in the specified lab using the EVENG client API.

  @mcp.tool()
  async def start_all_nodes(arguments: BulkNodeControlArgs) -> list[TextContent]:
      """
      Start all nodes in a lab.
  
      This tool starts all nodes in the specified lab. Nodes will be started
      according to their configured delay settings.
      """
      try:
          logger.info(f"Starting all nodes in {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."
              )]
  
          # Start all nodes
          result = await eveng_client.start_all_nodes(arguments.lab_path)
  
          if result.get('status') == 'success':
              return [TextContent(
                  type="text",
                  text=f"Successfully started all nodes in {arguments.lab_path}\n\n"
                       f"All nodes are now booting up. They may take a few moments to become fully operational."
              )]
          else:
              return [TextContent(
                  type="text",
                  text=f"Failed to start all nodes: {result.get('message', 'Unknown error')}"
              )]
  
      except Exception as e:
          logger.error(f"Failed to start all nodes: {e}")
          return [TextContent(
              type="text",
              text=f"Failed to start all nodes: {str(e)}"
          )]

• eveng_mcp_server/tools/node_management.py:59-62 (schema)

  Pydantic model defining the input schema for the start_all_nodes tool (and similar bulk operations).

  class BulkNodeControlArgs(BaseModel):
      """Arguments for bulk node operations."""
      lab_path: str = Field(description="Full path to the lab (e.g., /lab_name.unl)")

• eveng_mcp_server/tools/__init__.py:24-25 (registration)

  Registration call for node management tools, which includes start_all_nodes.

  # Node management tools
  register_node_tools(mcp, eveng_client)

• eveng_mcp_server/server.py:52-53 (registration)

  Main server registration that triggers all tools registration including node_management tools.

  # Register tools
  register_tools(self.mcp, self.eveng_client)

• eveng_mcp_server/core/eveng_client.py:427-437 (helper)

  Underlying EVENGClientWrapper method that calls the EVE-NG API to start all nodes.

  async def start_all_nodes(self, lab_path: str) -> Dict[str, Any]:
      """Start all nodes in a lab."""
      await self.ensure_connected()
  
      try:
          result = await asyncio.to_thread(self.api.start_all_nodes, lab_path)
          self.logger.info("Started all nodes", lab_path=lab_path)
          return result
      except Exception as e:
          self.logger.error("Failed to start all nodes", **log_error(e, {"lab_path": lab_path}))
          raise EVENGAPIError(f"Failed to start all nodes: {str(e)}")