MCP 服务器

EVE-NG MCP Server

A Model Context Protocol server that enables LLMs to manage network topologies, labs, nodes, and configurations in the EVE-NG network emulation platform through a standardized interface.

README

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 <repository-url>
cd eveng-mcp-server

# Install dependencies
uv sync

# Copy example configuration
cp .env.example .env

# Edit configuration as needed
nano .env

Configuration

The server can be configured using environment variables or a .env file:

# EVE-NG Server Settings
EVENG_HOST=eve.local
EVENG_PORT=80
EVENG_PROTOCOL=http
EVENG_USERNAME=admin
EVENG_PASSWORD=eve

# MCP Server Settings
MCP_TRANSPORT=stdio
MCP_LOG_LEVEL=INFO

See .env.example for all available configuration options.

Usage

Command Line Interface

# Run with stdio transport (default)
uv run eveng-mcp-server run

# Run with SSE transport
uv run eveng-mcp-server run --transport sse --host localhost --port 8000

# Test EVE-NG connection
uv run eveng-mcp-server test-connection --host eve.local --username admin --password eve

# Show configuration
uv run eveng-mcp-server config-info

# Show version
uv run eveng-mcp-server version

Available MCP Tools

Connection Management

connect_eveng_server - Connect to EVE-NG server
disconnect_eveng_server - Disconnect from server
test_connection - Test server connectivity
get_server_info - Get server information and status

Lab Management

list_labs - List available labs
create_lab - Create a new lab
get_lab_details - Get detailed lab information
delete_lab - Delete a lab

Node Management

list_node_templates - List available node templates
add_node - Add nodes to labs with comprehensive configuration
list_nodes - List lab nodes with status and details
get_node_details - Get detailed node information
start_node / stop_node - Control individual node power state
start_all_nodes / stop_all_nodes - Bulk node operations
wipe_node / wipe_all_nodes - Reset nodes to factory state
delete_node - Remove nodes from labs

Network Management

list_network_types - List available network types
list_lab_networks - List all networks in a lab
create_lab_network - Create networks with positioning
delete_lab_network - Remove networks from labs
connect_node_to_network - Connect nodes to networks
connect_node_to_node - Create point-to-point connections
get_lab_topology - Retrieve complete topology information

Testing

# Test EVE-NG connection
uv run eveng-mcp-server test-connection

# Run the server
uv run eveng-mcp-server run

📚 Documentation

Complete Guides

📖 API Reference - Complete documentation for all 25 tools, 4 resources, and 6 prompts
🚀 Deployment Guide - Production deployment with Docker, Kubernetes, and systemd
🔧 Troubleshooting Guide - Common issues and solutions
🧪 Testing Guide - Comprehensive testing procedures