SuricataMCP

SuricataMCP 🚀

SuricataMCP は、MCP クライアントが Suricata を自律的に使用してネットワークトラフィックを分析できるようにする Model Context Protocol サーバーです。get_suricata_version、get_suricata_help、get_alerts_from_pcap_file などのツールを通じて、Suricata とプログラムからやり取りできます。

📰 Medium の完全ガイド

ご参考までに、Cursor で SuricataMCP をインストールして使用する方法を手順ごとに説明した Medium の記事をご用意しました。 SuricataMCP で Cursor を強化：ネットワークセキュリティをすぐ手元に

---

📦 機能

• 🔡 Suricata のバージョンとヘルプ情報を簡単に取得できます。
• 📁 シンプルなツールインターフェースを使って .pcap ファイルを解析し、アラートを取得できます。
• 🧠 MCP プロトコルを使用して構築されており、Cursor などの AI コーディングツールとシームレスに統合できます。

---

⬇️ Suricata のダウンロード

このプロジェクトを使用するには、Suricata をダウンロードしてインストールする必要があります。

Suricata の公式サイトにアクセスしてください：https://suricata.io/download/

お使いの OS（Linux、macOS、または Windows）向けのインストール手順に従ってください。

Linux では、パッケージマネージャーを使ってインストールすることもできます。例：

bash sudo apt install suricata

インストール後、config.py で正しいパスを設定できるように、Suricata のバイナリと設定ファイルの場所を確認してください。

---

⚙️ インストールガイド

Smithery 経由でインストール

Smithery を使って、Claude Desktop 用の Suricata Network Traffic Analysis Server を自動的にインストールするには：

npx -y @smithery/cli install @Medinios/SuricataMCP --client claude

以下の手順に従って、システムに SuricataMCP をセットアップしてください。

---

1. リポジトリをクローン

ターミナルを開き、次を実行してください。

git clone https://github.com/medinios/SuricataMCP.git
cd SuricataMCP

2. 依存関係をインストール（仮想環境を使用する場合など）

pip install -r requirements.txt

3. config.py ファイルを編集して、Suricata のインストールパスを指定します。

SURICATA_DIR = "/path/to/suricata"
SURICATA_EXE_FILE = "suricata"  # or "suricata.exe" on Windows

4. 次の設定で SuricataMCP を AI プラットフォームに追加します。

  {
    "mcpServers": {
      "SuricataMcp": {
        "command": "cmd",
        "args": ["/c", "mcp", "run", "[YourPath]\\SuricataMcp\\suricata-mcp.py"]
      }
    }
  }

---

🚀 使用方法

Cursor などの AI プラットフォームから、MCP サーバーをローカルで実行します。

実行すると、サーバーは次の MCP ツールを公開します。

• get_suricata_version(): Suricata のバージョン文字列を返します。
• get_suricata_help(): Suricata CLI のヘルプ出力を返します。
• get_alerts_from_pcap_file(pcap_destination: str, destination_folder_results: str): 指定された .pcap ファイルで Suricata を実行し、fast.log の内容を返します。

---

📄 カスタムルールの追加

独自の検出ルールで Suricata を拡張するには：

1. カスタムルールファイル（例：custom.rules）を suricata/rules ディレクトリに追加します。

---

⚠️ 免責事項

当プロジェクトは、公式の Suricata プロジェクトおよび OISF（Open Information Security Foundation）とは提携していません。SuricataMCP は、Cursor 内で個人利用するために構築された独立した統合です。 サンプルの pcap は PCAP-ATTACK から取得しました。

---

🤝 貢献者

このプロジェクトは、セキュリティ、コンテキストを考慮したシステム、コミュニティに役立つツールの構築に情熱を注ぐ 2 人の開発者によって作られました。すべてのコード、すべての CLI コマンド、そしてすべての統合は、集中して協力し、好奇心を共有した成果です。

Sam Med, Raz Tel-Vered

🤝 コントリビューション

プルリクエストや提案を歓迎します！SuricataMCPをより使いやすく、プログラムから活用しやすくしていきましょう。