Ludus Fastmcp
L

Ludus Fastmcp

2.5 points
4.1K

Installation

Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.

🚀 Ludus FastMCP

A Model Context Protocol (MCP) server for automating Ludus cyber range environments through AI assistants written in Python. This project enables AI - powered management of Ludus cyber ranges via natural language commands.

Key Information

  • Version: Version
  • Python: Python
  • License:

🚀 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-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 --setup

The wizard configures API credentials, tests connectivity, and generates MCP client configuration files. For manual configuration options, see the Configuration Guide.

✨ Features

Key Capabilities

Property Details
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.

💻 Usage Examples

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

📄 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

  • Ludus by Bad Sector Labs
  • FastMCP, and the Model Context Protocol community.

Alternatives

R
Runno
Runno is a collection of JavaScript toolkits for securely running code in multiple programming languages in environments such as browsers and Node.js. It achieves sandboxed execution through WebAssembly and WASI, supports languages such as Python, Ruby, JavaScript, SQLite, C/C++, and provides integration methods such as web components and MCP servers.
TypeScript
5.9K
5 points
A
Aderyn
Aderyn is an open - source Solidity smart contract static analysis tool written in Rust, which helps developers and security researchers discover vulnerabilities in Solidity code. It supports Foundry and Hardhat projects, can generate reports in multiple formats, and provides a VSCode extension.
Rust
9.4K
5 points
S
Shadcn Ui MCP Server
An MCP server that provides shadcn/ui component integration for AI workflows, supporting React, Svelte, and Vue frameworks. It includes functions for accessing component source code, examples, and metadata.
TypeScript
12.5K
5 points
A
Annas MCP
The MCP server and CLI tool of Anna's Archive are used to search for and download documents on the platform and support access through an API key.
Go
9.2K
4.5 points
M
MCP Scan
MCP-Scan is a security scanning tool for MCP servers, used to detect common security vulnerabilities such as prompt injection, tool poisoning, and cross-domain escalation.
Python
16.5K
5 points
A
Agentic Radar
Agentic Radar is a security scanning tool for analyzing and assessing agentic systems, helping developers, researchers, and security experts understand the workflows of agentic systems and identify potential vulnerabilities.
Python
13.3K
5 points
M
MCP Server Weread
The WeRead MCP Server is a lightweight service that bridges WeRead data and AI clients, enabling in - depth interaction between reading notes and AI.
TypeScript
13.5K
4 points
M
MCP Youtube
Download YouTube subtitles via yt - dlp and connect to Claude.ai through the MCP protocol for video content analysis
TypeScript
12.1K
4 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
17.6K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
29.7K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
20.2K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
57.9K
4.3 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
54.7K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
25.2K
5 points
C
Context7
Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.
TypeScript
80.0K
4.7 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
38.6K
4.8 points
AIBase
Zhiqi Future, Your AI Solution Think Tank
© 2025AIBase