EVE-NG MCP Server

A comprehensive Model Context Protocol (MCP) server for EVE-NG network emulation platform integration. This server exposes EVE-NG’s full API capabilities through MCP’s standardized interface, enabling LLMs to manage network topologies, labs, nodes, and configurations.

Features

🔌 Connection Management

• Secure authentication with EVE-NG servers
• Connection testing and health monitoring
• Session management with automatic reconnection
• Support for both HTTP and HTTPS protocols

🧪 Lab Management

• Create, list, and delete labs
• Comprehensive lab information retrieval
• Lab metadata management (description, author, version)
• Import/export capabilities (planned)

🖥️ Node Management

• Add and configure nodes with various templates
• Start, stop, and manage node lifecycle
• Bulk operations for multiple nodes
• Node configuration and status monitoring
• Comprehensive template and image support

🌐 Network Management

• Create and manage networks (clouds, bridges, NAT)
• Connect nodes to networks and each other
• Topology visualization and management
• Network configuration and monitoring

📊 MCP Resources & Prompts

• Dynamic resources for real-time lab status
• Static resources for documentation and examples
• Guided prompts for common workflows
• Educational content generation

🔗 Client Integrations

The EVE-NG MCP Server integrates seamlessly with popular MCP-compatible clients:

🤖 Claude Desktop

Use EVE-NG directly in conversations with Claude Desktop for natural language network management:

{
  "mcpServers": {
    "eveng-mcp-server": {
      "command": "uv",
      "args": ["run", "eveng-mcp-server", "run", "--transport", "stdio"],
      "env": {
        "EVENG_HOST": "eve.local",
        "EVENG_USERNAME": "admin",
        "EVENG_PASSWORD": "eve"
      }
    }
  }
}

📖 Complete Claude Desktop Integration Guide →

💻 VS Code

Integrate with VS Code for enhanced network development workflows:

• Lab deployment from configuration files
• Automated testing and validation
• Topology visualization and documentation
• Custom tasks and debugging support

💻 Complete VS Code Integration Guide →

🔍 MCP Inspector

Test and debug the server using the MCP Inspector:

# Start server in SSE mode
uv run eveng-mcp-server run --transport sse --host 0.0.0.0 --port 8000

# Start MCP Inspector
npx @modelcontextprotocol/inspector

🔗 All Integration Guides →

Installation

Prerequisites

• Python 3.11 or higher
• UV package manager
• Access to an EVE-NG server

Using UV (Recommended)

# Clone the repository
git clone 
cd eveng-mcp-server

# Install dependencies
uv sync

# Copy example configuration
cp .env.example .env

# Edit configuration as needed
nano .env

Configuration