Ludus Fastmcp

🚀 Ludus FastMCP

Ludus FastMCP 是一個基於 Python 編寫的模型上下文協議（MCP）服務器，藉助人工智能助手實現對 Ludus 網絡靶場環境的自動化管理。它通過自然語言命令為 Ludus 網絡靶場提供了強大的管理能力。

🚀 快速開始

要求

• Python 3.11 及以上版本
• 可訪問 Ludus 服務器實例
• 具備 Ludus API 憑證

安裝

# 使用 pipx（推薦）
pipx install git+https://github.com/tjnull/Ludus-FastMCP

# 從源碼安裝
git clone https://github.com/tjnull/Ludus-FastMCP
cd Ludus-FastMCP
pip install -e .

配置

運行交互式配置嚮導：

ludus-fastmcp --setup

該向導會配置 API 憑證、測試連接，並生成 MCP 客戶端配置文件。如需手動配置選項，請參閱 配置指南。

✨ 主要特性

核心功能概述

Ludus FastMCP 可通過自然語言命令實現對 Ludus 網絡靶場的人工智能管理。該服務器在 15 個模塊中提供了 157 種工具，用於靶場生命週期管理、場景部署、模板創建、Ansible 角色管理以及安全監控集成。

關鍵能力

支持的平臺

可與任何兼容 MCP 的客戶端配合使用，包括 Claude Desktop、VS Code（Cline）、OpenWebUI 和 AnythingLLM。

💻 使用示例

MCP 服務器（ludus-fastmcp）

ludus-fastmcp --setup          # 交互式配置嚮導
ludus-fastmcp --list-tools     # 列出所有 157 種可用工具
ludus-fastmcp --version        # 顯示版本信息
ludus-fastmcp                  # 啟動 MCP 服務器
ludus-fastmcp --daemon         # 作為後臺服務運行

客戶端 CLI（ludus-ai）

ludus-ai setup-llm                    # 配置本地大語言模型（Ollama）
ludus-ai install anythingllm          # 安裝 AnythingLLM 接口
ludus-ai tool list-tools              # 列出可用工具
ludus-ai tool call-tool <name>        # 直接執行工具

交互示例

連接到 MCP 客戶端後，可與 Ludus 環境進行交互：

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

以下是通過 Opencode 使用 Ludus-FastMCP 與 grok 代碼的示例：

📚 詳細文檔

📦 資源鏈接

🛠️ 支持渠道

• GitHub 問題 - 用於提交 bug 報告和功能請求
• GitHub 討論 - 用於提問和社區交流

📄 許可證

本項目採用 MIT 許可證。詳情請參閱 LICENSE。

⚠️ 免責聲明

本軟件僅用於授權的安全測試、教育目的以及在受控環境中的研究。用戶需自行遵守適用的法律法規和組織政策。作者不提供任何保證，也不對軟件的使用或濫用承擔任何責任。

🙏 致謝

• Ludus 由 Bad Sector Labs 開發
• FastMCP 以及模型上下文協議社區