Supports configuration via .env files, allowing users to set EVE-NG server credentials, connection settings, and MCP server parameters through environment variables.
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:
๐ 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:
๐ All Integration Guides โ
Installation
Prerequisites
Python 3.11 or higher
UV package manager
Access to an EVE-NG server
Using UV (Recommended)
Configuration
The server can be configured using environment variables or a .env
file:
See .env.example
for all available configuration options.
Usage
Command Line Interface
Available MCP Tools
Connection Management
connect_eveng_server
- Connect to EVE-NG serverdisconnect_eveng_server
- Disconnect from servertest_connection
- Test server connectivityget_server_info
- Get server information and status
Lab Management
list_labs
- List available labscreate_lab
- Create a new labget_lab_details
- Get detailed lab informationdelete_lab
- Delete a lab
Node Management
list_node_templates
- List available node templatesadd_node
- Add nodes to labs with comprehensive configurationlist_nodes
- List lab nodes with status and detailsget_node_details
- Get detailed node informationstart_node
/stop_node
- Control individual node power statestart_all_nodes
/stop_all_nodes
- Bulk node operationswipe_node
/wipe_all_nodes
- Reset nodes to factory statedelete_node
- Remove nodes from labs
Network Management
list_network_types
- List available network typeslist_lab_networks
- List all networks in a labcreate_lab_network
- Create networks with positioningdelete_lab_network
- Remove networks from labsconnect_node_to_network
- Connect nodes to networksconnect_node_to_node
- Create point-to-point connectionsget_lab_topology
- Retrieve complete topology information
Testing
๐ 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
Integration Guides
๐ค Claude Desktop Integration - Natural language network management
๐ป VS Code Integration - Enhanced development workflows
๐ All Integrations - Complete integration documentation
Examples
๐ Configuration Examples - Ready-to-use configurations
๐งช Test Scripts - Comprehensive test suite with examples
๐ Sample Labs - Example network topologies
๐ฏ 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
Install:
git clone <repo> && cd eveng-mcp-server && uv sync
Configure: Copy
.env.example
to.env
and set your EVE-NG credentialsTest:
uv run eveng-mcp-server test-connection
Integrate: Follow our Claude Desktop or VS Code guides
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
Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: Complete Documentation
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
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.
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -45138MIT License
- -securityAlicense-qualityA 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 -20Apache 2.0
- AsecurityFlicenseAqualityA 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 -41013
- -securityAlicense-qualityA command-line tool for creating and running Model Context Protocol servers that expose resources, tools, and prompts to LLM clients.Last updated -3791AGPL 3.0