Which integrations are available for this server?

Provides [Ansible](/mcp/servers/integrations/ansible) role management capabilities including Ansible Galaxy integration and custom role installation for configuring Ludus cyber range environments. Enables SIEM integration with [Elastic Stack](/mcp/servers/integrations/elastic-stack) for security monitoring and logging within Ludus cyber range deployments. Supports configuration of local LLM through [Ollama](/mcp/servers/integrations/ollama) for AI-powered management of Ludus environments via the ludus-ai CLI tool. Enables SIEM integration with [Splunk](/mcp/servers/integrations/splunk) for security monitoring and event management in Ludus cyber range environments.

Ludus FastMCP

Version Python License

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 157 tools across 15 modules for range lifecycle management, scenario deployment, template creation, Ansible role management, and security monitoring integration.

Key Capabilities

Category	Description
Range Management	Create, configure, deploy, and manage virtual lab environments
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 and custom role installation
SIEM Integration	Wazuh, Splunk, Elastic Stack, and Security Onion support
AI Configuration	Natural language to YAML configuration conversion

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
Ludus API credentials

Installation

# Using pipx (recommended) pipx install git+https://github.com/tjnull/ludus-mcp-python.git # From source git clone https://github.com/tjnull/ludus-mcp-python.git cd ludus-mcp-python pip install -e .

Setup

Run the interactive setup wizard:

ludus-fastmcp --setup

The 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 157 available tools ludus-fastmcp --version # Display version information ludus-fastmcp # Start MCP server ludus-fastmcp --daemon # Run as background service

Client 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 directly

Example 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

Examples of using Ludus-FastMCP with grok code through Opencode.

Documentation

Document	Description
Getting Started	Installation, setup, and first deployment
Configuration	Environment variables and MCP client setup
Tools Reference	Complete documentation for all 157 tools
Scenarios	Pre-built deployment scenarios
Troubleshooting	Common issues and solutions
Safety	Safety features and best practices

Resources

Resource	Link
Ludus Documentation	docs.ludus.cloud
Ludus GitHub	github.com/badsectorlabs/ludus
FastMCP Framework	gofastmcp.com
MCP Specification	modelcontextprotocol.io

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.