Ludus Fast MCP

MCP安全风控

提供方 tjnull

安全风控 HTTP · 远程 API Key 社区 / 第三方
查看接入方式

Enables AI-powered management of Ludus cyber range environments through natural language commands. Provides 157 tools for range lifecycle management, scenario deployment, template creation, Ansible role management, and SIEM integration for security testing and research.

一句话选型结论

按资料字段整理

Ludus Fast MCP 属于安全风控类 MCP 服务器,HTTP · 远程,API Key,有可直接复制的远程端点配置。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类安全风控 传输方式HTTP · 远程 鉴权API Key 部署方式支持远程部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

安全风控
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

安装与配置

HTTP · 远程 API Key
连远程 HTTPS 端点,通常为 Streamable HTTP
pip install -e .

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
资产与漏洞排查

盘点资产、扫漏洞、看暴露面。

日志与审计

汇总日志、查异常行为。

合规检查

按规则检查配置与权限是否合规。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在安全风控场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ludus Fast MCP当前 未标注 HTTP · 远程 支持远程部署 有 2026-05-17
Cyber Strike AI 75 未标注 未标注 无 2026-05-17
mcp-for-beginners 未标注 stdio · 本地进程 本地部署 有 2026-04-13
casdoor 未标注 stdio · 本地进程 本地部署 有 2026-04-12
kubeshark 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Modelcontextprotocol C22988b0 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

安全风控
字段来自项目仓库与公开索引,中文说明由本站标注
提供方tjnull上游标注的维护方 tjnull
分类安全风控本站按上游分类展示
连接方式HTTP · 远程连远程 HTTPS 端点,通常为 Streamable HTTP
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.1 KB
来自项目仓库与上游目录的原文,未做删改

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

Requires Ludus 2.0 or later. This release targets the Ludus 2.x API only, which is what makes blueprints, groups, content sources, VM console access, quotas and diagnostics available. Support for the Ludus 1.x API was removed; pin ludus-fastmcp to a 1.x release if you still run a Ludus 1.x server.

The client covers every endpoint in the Ludus API, validated against a live Ludus 2.3.0 server.

Key Capabilities

Category Description
Range Management Create, configure, deploy, and manage virtual lab environments
Blueprints Create, export, import, share, and apply reusable range configurations
Content Sources Add git or archive catalogs of templates, roles, and prebuilt labs such as GOAD
Groups Organize users and ranges with group-based access control
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, subscription roles, and scope control
SIEM Integration Wazuh, Splunk, Elastic Stack, and Security Onion support
AI Configuration Natural language to YAML configuration conversion
Diagnostics System health, license info, deployment log history, and migration tools
Quotas & Limits Per-user and per-group resource quotas, plus range auto-shutdown (plugin)

Supported Platforms

Works with any MCP-compatible client including Claude Desktop, VS Code (Cline), OpenWebUI, and AnythingLLM.

Quick Start

Requirements

  • Python 3.11+
  • FastMCP 3.x (installed automatically)
  • A Ludus server running 2.0 or later
  • Ludus API key, or a JWT token for Pro/SSO deployments

Installation```bash

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:```bash
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)```bash

ludus-fastmcp --setup # Interactive setup wizard
ludus-fastmcp --list-tools # List all 231 available tools
ludus-fastmcp --version # Display version information
ludus-fastmcp # Start MCP server
ludus-fastmcp --daemon # Run as background service


### Client CLI (ludus-ai)```bash
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
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 members


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 231 tools |
| Scenarios | Pre-built deployment scenarios |
| Troubleshooting | Common issues and solutions |
| Safety | Safety features and best practices |

## Ludus Server Requirements

This release speaks the Ludus 2.x API only. Every request goes to `/api/v2`;
there is no v1 code path left to fall back to.

On the first call the client asks the server for its version and refuses to
continue if it does not answer as a 2.x server, so a mismatch surfaces once, up
front, instead of as a puzzling 404 from whichever tool you happened to run:```
https://ludus.example:8080 does not serve the Ludus 2.x API
(GET /api/v2/ returned HTTP 404). This release requires Ludus 2.0 or later;
upgrade the server, or pin ludus-fastmcp to a 1.x release for a Ludus 1.x server.

Set LUDUS_API_VERSION=v2 to assert the version yourself and skip that check
(it saves one request per session). LUDUS_API_VERSION=v1 is rejected at
startup rather than silently ignored.

Still on Ludus 1.x?

Pin an older release:```bash
pipx install "git+https://github.com/tjnull/Ludus-FastMCP@v1.0.0"


Upgrading the server is the better path: blueprints, content sources, groups,
quotas, deployment log history and VM console access do not exist in the 1.x
API at all.

### Plugin-gated features

Some Ludus capabilities ship as server plugins that may not be loaded on a given
install. Quotas and auto-shutdown are the common examples. When a plugin is
absent, the Ludus API answers with HTTP 404 even though the request was correct.

Rather than reporting that as a missing endpoint, those tools return a clear
result so an AI assistant does not go hunting for a nonexistent bug:```json
{
  "available": false,
  "feature": "Quotas",
  "error": "Quotas is not available on this Ludus server.",
  "reason": "This capability is provided by a Ludus plugin that is not loaded on the server.",
  "hint": "The request was well-formed. Do not retry or try alternative endpoints."
}

Endpoints a server does not implement at all (HTTP 501, such as /range/sshconfig
on some builds) are reported the same way, with an explicit note that retrying
will not help.

Resources

Resource Link
Ludus Documentation docs.ludus.cloud
Ludus API Reference api-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.

Acknowledgments

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

Credits

  • @LouDeter - MCP request/response logging middleware and log-file support (PR #8)

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Ludus Fast MCP 怎么安装?

在客户端按下面的安装命令接入:pip install -e .。装完在客户端配置里引用同一个包或端点。

Ludus Fast MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Ludus Fast MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ludus Fast MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Ludus Fast MCP 能提供哪些能力?

资料显示能力标签包括 安全、Python、AI自动化、API密钥。具体工具清单以官方文档为准。

Ludus Fast MCP 需要什么运行环境?

运行时为 Python;属于远程端点,不需要在本地装运行时。

Ludus Fast MCP 是本地还是远程?

它是远程端点,连服务地址即可。传输方式为HTTP · 远程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。