Skip to main content
Glama

EVE-NG MCP Server

by moimran

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

Integration Guides

Examples

๐ŸŽฏ Development Status

  • โœ… Production Ready - Complete MCP server implementation

  • โœ… EVE-NG Integration - Full API coverage with 25 tools

  • โœ… Client Integrations - Claude Desktop and VS Code support

  • โœ… Comprehensive Testing - Unit, integration, and E2E tests

  • โœ… Production Deployment - Docker, Kubernetes, systemd ready

  • โœ… Complete Documentation - API reference, guides, and examples

  • โœ… MCP Resources - 4 dynamic and static resources

  • โœ… MCP Prompts - 6 guided workflow prompts

๐Ÿš€ Quick Start

  1. Install: git clone <repo> && cd eveng-mcp-server && uv sync

  2. Configure: Copy .env.example to .env and set your EVE-NG credentials

  3. Test: uv run eveng-mcp-server test-connection

  4. Integrate: Follow our Claude Desktop or VS Code guides

  5. Deploy: Use our production deployment guide for production use

๐Ÿค Contributing

We welcome contributions! Please see our Contributing Guide for details on:

  • Code style and standards

  • Testing requirements

  • Documentation guidelines

  • Pull request process

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ†˜ Support

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol server that gives LLMs the ability to interact with Ethereum networks, manage wallets, query blockchain data, and execute smart contract operations through a standardized interface.
    Last updated -
    45
    13
    8
    MIT License
  • -
    security
    A
    license
    -
    quality
    A Model Context Protocol server implementation that enables LLMs to interact with NebulaGraph database for graph exploration, supporting schema understanding, queries, and graph algorithms.
    Last updated -
    20
    Apache 2.0
  • A
    security
    F
    license
    A
    quality
    A Model Context Protocol server that enables LLMs to explore and interact with API specifications by providing tools for loading, browsing, and getting detailed information about API endpoints.
    Last updated -
    4
    10
    13
  • -
    security
    A
    license
    -
    quality
    A command-line tool for creating and running Model Context Protocol servers that expose resources, tools, and prompts to LLM clients.
    Last updated -
    379
    1
    AGPL 3.0

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/moimran/eveng-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server