Ludus Fastmcp

🚀 Ludus FastMCP

Pythonで書かれたAIアシスタントを通じて、Ludusサイバーレンジ環境を自動化するためのモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使うことで、自然言語コマンドによるサイバーレンジのAI管理が可能です。

🚀 クイックスタート

必要条件

• 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は、自然言語コマンドを通じて、AIによるLudusサイバーレンジの管理を可能にします。サーバーは15のモジュールにまたがる157のツールを公開しており、レンジのライフサイクル管理、シナリオのデプロイ、テンプレートの作成、Ansibleロールの管理、セキュリティ監視の統合などを行うことができます。

主要機能一覧

サポートされるプラットフォーム

Claude Desktop、VS Code (Cline)、OpenWebUI、AnythingLLMなど、MCP互換のクライアントで動作します。

💻 使用例

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                    # ローカル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を通じてgrokコードでLudus-FastMCPを使用する例です。

📚 ドキュメント

🔗 リソース

🛠️ サポート

• GitHub Issues - バグレポートと機能要求
• GitHub Discussions - 質問とコミュニティディスカッション

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEを参照してください。

🚧 免責事項

このソフトウェアは、許可されたセキュリティテスト、教育目的、および制御された環境での研究を目的としています。ユーザーは、適用される法律および組織のポリシーに準拠する責任を負います。作者は、このソフトウェアの使用または誤使用に対していかなる保証もせず、責任を負いません。

🙏 謝辞

• Bad Sector LabsによるLudus
• FastMCP、およびModel Context Protocolコミュニティ