EVE-NG MCP Server

Instructions

Implementation Reference

• eveng_mcp_server/tools/lab_management.py:25-32 (schema)

  Pydantic model defining the input schema/arguments for the create_lab tool.

  class CreateLabArgs(BaseModel):
      """Arguments for create_lab tool."""
      name: str = Field(description="Name of the lab")
      path: str = Field(default="/", description="Path where to create the lab (default: /)")
      description: str = Field(default="", description="Lab description")
      author: str = Field(default="", description="Lab author")
      version: str = Field(default="1", description="Lab version")

• eveng_mcp_server/tools/lab_management.py:97-140 (handler)

  The core handler function for the 'create_lab' tool. It checks connection, calls the EVE-NG client to create the lab, and returns success or error messages as TextContent.

  @mcp.tool()
  async def create_lab(name: str, path: str = "/", description: str = "", author: str = "", version: str = "1") -> list[TextContent]:
      """
      Create a new lab in EVE-NG.
  
      This tool creates a new lab with the specified name and metadata
      in the given path on the EVE-NG server.
      """
      try:
          logger.info(f"Creating lab: {name} in {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 lab
          lab = await eveng_client.create_lab(
              name=name,
              path=path,
              description=description,
              author=author,
              version=version
          )
  
          return [TextContent(
              type="text",
              text=f"Successfully created lab!\n\n"
                   f"Name: {name}\n"
                   f"Path: {path}\n"
                   f"Description: {description}\n"
                   f"Author: {author}\n"
                   f"Version: {version}\n\n"
                   f"Lab is ready for adding nodes and networks."
          )]
  
      except Exception as e:
          logger.error(f"Failed to create lab: {e}")
          return [TextContent(
              type="text",
              text=f"Failed to create lab: {str(e)}"
          )]

• eveng_mcp_server/tools/__init__.py:21-22 (registration)

  Registration call for lab management tools (including create_lab) within the central register_tools function.

  # Lab management tools
  register_lab_tools(mcp, eveng_client)

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

  Top-level registration of all tools (including create_lab) in the MCP server initialization.

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