Ludus FastMCP
Ludus FastMCP is an AI-powered MCP server that automates Ludus cyber range environments through natural language commands, exposing 157 tools across 15 modules for comprehensive lab management.
Core Capabilities:
Range Lifecycle Management: Create, configure, deploy, abort, power on/off, clone, and delete cyber ranges with bulk VM operations and testing mode controls
Scenario Deployment: Deploy 13 pre-built scenarios (red/blue/purple team, malware analysis, wireless labs) with customization, randomization, and SIEM integration (Wazuh, Splunk, Elastic Stack, Security Onion)
Template Management: Build, validate, optimize, and manage custom OS and container templates with dependency tracking and build logs
Snapshot Management: Create, list, rollback, and remove VM snapshots with scheduled automation and retention policies
SIEM Integration: Alert management, agent monitoring, detection summaries, and security event analysis across multiple SIEM platforms
User & Access Control: Manage users, API keys, and granular range access permissions
Network Operations: Visualize topology, test connectivity, diagnose issues, capture traffic with BPF filtering, and export SSH/RDP configurations
Deployment Control: Smart deployment with validation, monitoring, recovery tools, and Ansible tag-based resumption (base, domain, user, configure)
Security & Compliance: Run audits, compliance checks (NIST, PCI, ISO27001), vulnerability scans, and credential rotation
Metrics & Reporting: Monitor CPU, memory, disk, network usage with cost estimations; export in JSON, CSV, or Prometheus formats
Automation & Integration: Create deployment pipelines, schedule tasks with cron, configure auto-scaling, and integrate with webhooks, Slack, Jira, and Git repositories
Backup & Recovery: Export/import range backups, clone ranges with snapshots, and access recovery recommendations for failed deployments
Documentation & Training: Generate range documentation (markdown, HTML, PDF), attack path analysis, lab guides with solutions, and scenario playbooks
Community & Sharing: Import community scenarios and share range configurations publicly or with specific users
Provides Ansible role management capabilities including Ansible Galaxy integration and custom role installation for configuring Ludus cyber range environments.
Enables SIEM integration with Elastic Stack for security monitoring and logging within Ludus cyber range deployments.
Supports configuration of local LLM through Ollama for AI-powered management of Ludus environments via the ludus-ai CLI tool.
Enables SIEM integration with Splunk for security monitoring and event management in Ludus cyber range environments.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Ludus FastMCPdeploy an Active Directory lab with Wazuh monitoring"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Ludus FastMCP
A Model Context Protocol (MCP) server for automating Ludus cyber range environments through AI assistants written in Python.
Overview
Ludus FastMCP enables AI-powered management of Ludus cyber ranges through natural language commands. The server exposes 190+ tools across 20 modules for range lifecycle management, scenario deployment, template creation, Ansible role management, and security monitoring integration.
Supports both Ludus v1 and v2 with automatic version detection. All existing v1 tools work unchanged, and v2 adds blueprints, groups, VM console, diagnostics, enhanced range management, and more.
Key Capabilities
Category | Description |
Range Management | Create, configure, deploy, and manage virtual lab environments |
Blueprints | Save, share, and apply reusable range configurations (v2) |
Groups | Organize users and ranges with group-based access control (v2) |
Scenario Deployment | Pre-built scenarios for AD, red/blue/purple team, and malware analysis |
Template Builder | Custom OS templates, skeleton configurations, and YAML generation |
Role Management | Ansible Galaxy integration, custom roles, and subscription roles |
SIEM Integration | Wazuh, Splunk, Elastic Stack, and Security Onion support |
AI Configuration | Natural language to YAML configuration conversion |
Diagnostics | System health, license info, and migration tools (v2) |
Supported Platforms
Works with any MCP-compatible client including Claude Desktop, VS Code (Cline), OpenWebUI, and AnythingLLM.
Quick Start
Requirements
Python 3.11+
Access to a Ludus server instance (v1 or v2)
Ludus API key or JWT token (for v2 Pro/SSO users)
Installation
# Using pipx (recommended)
pipx install git+https://github.com/tjnull/Ludus-FastMCP
# From source
git clone https://github.com/tjnull/Ludus-FastMCP
cd Ludus-FastMCP
pip install -e .Setup
Run the interactive setup wizard:
ludus-fastmcp --setupThe wizard configures API credentials, tests connectivity, and generates MCP client configuration files.
For manual configuration options, see the Configuration Guide.
Usage
MCP Server (ludus-fastmcp)
ludus-fastmcp --setup # Interactive setup wizard
ludus-fastmcp --list-tools # List all 190+ available tools
ludus-fastmcp --version # Display version information
ludus-fastmcp # Start MCP server
ludus-fastmcp --daemon # Run as background serviceClient CLI (ludus-ai)
ludus-ai setup-llm # Configure local LLM (Ollama)
ludus-ai install anythingllm # Install AnythingLLM interface
ludus-ai tool list-tools # List available tools
ludus-ai tool call-tool <name> # Execute tools directlyExample Interactions
Once connected to an MCP client, interact with your Ludus environment:
Show my current range status
Deploy an Active Directory lab with Wazuh monitoring
Create a snapshot named "pre-attack" for all VMs
Build a lab with 2 domain controllers and 5 workstations
Create a blueprint from my current range and share it with the red-team group
Show system diagnostics and storage usage
List all groups and their membersExamples of using Ludus-FastMCP with grok code through Opencode.




Documentation
Document | Description |
Installation, setup, and first deployment | |
Environment variables and MCP client setup | |
Complete documentation for all 190+ tools | |
Pre-built deployment scenarios | |
Common issues and solutions | |
Safety features and best practices |
Ludus Version Compatibility
Feature | Ludus v1 | Ludus v2 |
Auto-detection | Automatic | Automatic |
API Key auth | Yes | Yes |
JWT auth (Pro/SSO) | No | Yes |
Range management | Yes | Yes |
Snapshots | Yes | Yes |
Templates | Yes | Yes (+ subscription roles) |
Blueprints | No | Yes |
Groups | No | Yes |
VM Console | No | Yes |
Diagnostics | No | Yes |
Multi-range access | No | Yes |
Version is auto-detected on first API call. Override with LUDUS_API_VERSION=v1 or LUDUS_API_VERSION=v2. v2-only tools return a clear error message when used against a v1 server.
Resources
Resource | Link |
Ludus Documentation | |
Ludus API Reference | |
Ludus GitHub | |
FastMCP Framework | |
MCP Specification |
Support
GitHub Issues - Bug reports and feature requests
GitHub Discussions - Questions and community discussion
License
This project is licensed under the MIT License. See LICENSE for details.
Disclaimer
This software is intended for authorized security testing, educational purposes, and research in controlled environments. Users are responsible for compliance with applicable laws and organizational policies. The authors make no warranties and assume no liability for use or misuse of this software.
Acknowledgments
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
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/tjnull/Ludus-FastMCP'
If you have feedback or need assistance with the MCP directory API, please join our Discord server