crowdsecurity/crowdsec-local-mcp

人生はYAMLを書くのに短すぎる、ただうまく尋ねる!

モデルコンテキストプロトコル(MCP)サーバーがクラウドSec WAFルールとScenariosを生成、検証、デプロイします。

##特徴

WAFルールの特徴

• WAFルール生成:ユーザー入力またはCVE参照からクラウドSec WAFルールを生成
• 評価: WAFルールの構文的矯正を検証 -Linting:WAFルールを改善するための警告とヒントを入手 -Deployment Guide:ステップバイステップの展開手順
• ドッカーテストハーネス: クラウドSec + nginx + バウンサーをスピンアップして、偽陽性/負のためのルールを行使する
• Nuclei Lookup: 与えられたCVEのための公式[projectdiscovery/nuclei-templatesリポジトリに既存のテンプレートに素早くジャンプ

シナリオの特徴

• クラウドSecシナリオ生成:クラウドSecシナリオの生成
• 評価: シナリオの構文的矯正を検証 -Linting:あなたのシナリオを改善するために警告とヒントを得る -Deployment Guide:ステップバイステップの展開手順
• ドッカーテストハーネス:シナリオ動作をテストするためにクラウドSecをスピンアップ

デモ

WAFルールの作成とテスト

• 自然言語のルール作成
• CVE参照からルール作成

Life is too short to write YAML, just ask nicely!

A Model Context Protocol (MCP) server to generate, validate, and deploy CrowdSec WAF rules & Scenarios.

Features

WAF Rules Features

• WAF Rule Generation: Generate CrowdSec WAF rules from user input or a CVE reference
• Validation: Validate syntaxical correctness of WAF rules
• Linting: Get warnings and hints to improve your WAF rules
• Deployment Guide: Step-by-step deployment instructions
• Docker Test Harness: Spin up CrowdSec + nginx + bouncer to exercise rules for false positives/negatives
• Nuclei Lookup: Quickly jump to existing templates in the official projectdiscovery/nuclei-templates repository for a given CVE

Scenarios Features

• CrowdSec Scenarios Generation: Generate CrowdSec scenarios
• Validation: Validate syntaxical correctness of scenarios
• Linting: Get warnings and hints to improve your scenarios
• Deployment Guide: Step-by-step deployment instructions
• Docker Test Harness: Spin up CrowdSec to test scenario behavior

Demo

WAF Rules Creation and testing

• Rule creation from natural language
• Rule creation from CVE reference

Scenario Creation and testing

• Rule creation on HTTP events
• Rule creation based on GeoLocation factors

Prerequisites

• uv 0.4 or newer, which provides the uvx runner used in the examples below.
• Docker with the Compose plugin (Compose v2).

Installation

You can install the MCP using uvx or use packaged .mcpb file for claude code.

Using .mcpb package

If you’re using claude desktop, you can configure the MCP directly by double-clicking the .mcpb file that accompanies the release.

[!IMPORTANT] On MacOS, configure uv path in the extension settings if uv isn’t installed in the standard path.

Using uvx

• Configure supported clients automatically with uvx --from crowdsec-local-mcp init , where `` is one of claude-desktop, claude-code, chatgpt, vscode, or stdio:

uvx --from crowdsec-local-mcp init --dry-run claude-code

Run uvx --from crowdsec-local-mcp init --help to see all flags and supported targets.

What init configures

The init helper writes the CrowdSec MCP server definition into the client’s JSON configuration:

• claude-desktop → claude_desktop_config.json in the Claude Desktop settings directory
• claude-code → invoke claude mcp command with needed args