Ludus FastMCP Server

Provides AI-powered management of Ludus cyber ranges with 157 tools across 15 modules for lifecycle management, deployment, templating, Ansible roles, and SIEM integration.

python

15

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tjnull-ludus-fastmcp": {
      "command": "ludus-fastmcp",
      "args": []
    }
  }
}

You manage Ludus cyber range environments with an MCP server that translates natural language commands into automated range operations. This server orchestrates lab deployment, scenario setup, template creation, and security monitoring integrations, making it easier to run consistent, AI-assisted training environments across your infrastructure.

How to use

You interact with the MCP server through a client that speaks the Model Context Protocol. Start the server locally, then connect with your MCP client to issue commands in natural language and receive structured responses that drive Ludus environments.

Typical usage patterns include deploying labs, applying monitoring, taking snapshots, and building templates. You can describe your desired state in plain language, and the MCP client translates that into actions such as deploying a lab with domain controllers and workstations, enabling Wazuh monitoring, or generating a YAML template for future reuse.

How to install

Prerequisites: you need Python 3.11 or newer and access to a Ludus server instance with valid API credentials.

Install the MCP server package using the recommended method for your environment.

# 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 .

Additional setup and startup

Run the interactive setup wizard to configure API credentials and verify connectivity.

ludus-fastmcp --setup

Operational notes

After setup, you can start the MCP server in the foreground or as a daemon, and then use the client to list tools, check version, and deploy labs.

Start the server in the foreground: run the server command without daemonizing.

ludus-fastmcp

Configuration and security

Manage credentials and connection settings through the interactive wizard. Ensure you keep API credentials and access tokens secure and limit access to authorized users and automation workflows.

Troubleshooting and notes

If you encounter connectivity or setup issues, re-run the setup wizard, verify API keys, and confirm that the Ludus server instance is reachable from the host running the MCP server.

Examples of common tasks

Deploy a lab with AD and monitoring enabled
Create a snapshot named "pre-attack" for all VMs
Build a lab with 2 domain controllers and 5 workstations