Velociraptor MCPサーバー

作成者: mgreen27/mcp-velociraptor 追加・編集: Snoe Findley

Velociraptor Model Context Protocol (MCP) サーバーは、デジタルフォレンジックおよびインシデントレスポンス（DFIR）向けに設計された統合インターフェースです。LLMフレームワーク（Claude、Gemini、Open WebUI、n8nなど）が、Velociraptorエンドポイント監視エンジンとプログラム的に連携することを可能にします。

概要

このMCPサーバーは、標準的なVelociraptorの機能をAIエージェントに公開し、以下の操作を可能にします：

• YARAを使用したファイルおよびメモリスキャンの実施。

• ネットワーク隔離やプロセス終了を含む修復アクションの実行。

• Windows、macOS、Linuxにわたるアーティファクトの収集（例：MFT解析、イベントログ抽出、USNジャーナル分析、プロセスメモリ検査）。

セキュリティ上の注意: このサーバーは、トークンオーバーフローを緩和し、VQLインジェクションを防ぐために、データ制限とVQL文字列のサニタイズを強制します。また、任意のコマンドラインスクリプトを実行するのではなく、エンドポイントの安定性を確保するために、標準の組み込みVelociraptorアーティファクトに依存しています。

Related MCP server: Velociraptor MCP Server

1. 前提条件

稼働中のVelociraptorサーバーと、対応するAPI設定ファイルが必要です。さらに、以下が必要です：

• ローカル（stdio）デプロイの場合: Python 3.10以降がインストールされていること。

• ネットワーク（SSE）デプロイの場合: DockerおよびDocker Composeがインストールされていること。

1. Velociraptorサーバー上に専用のAPIユーザーを作成します：

   velociraptor --config /etc/velociraptor/server.config.yaml config api_client --name mcp_agent --role administrator,api api_client.yaml

2. api_client.yaml をこのプロジェクトのルートディレクトリにコピーします。

3. .env.example を .env にリネームし、設定環境変数をマッピングします：

   VELOCIRAPTOR_API_CONFIG=api_client.yaml

2. ローカルデプロイ（stdio）

標準入出力（stdio）を介したデプロイは、Claude Desktop、Claude Code、Gemini CLI などのローカルデスクトップクライアントに推奨される構成です。

セットアップ

1. Python 3.10以降がインストールされていることを確認します。

2. 仮想環境を初期化し、有効化します：

   python -m venv .venv
   # Windows
   .venv\Scripts\activate 
   # Mac/Linux
   source .venv/bin/activate

3. 依存関係をインストールします：

   pip install -r requirements.txt

クライアントの接続

MCPクライアントの設定ファイルに、stdio トランスポートを使用して接続を追加します。仮想環境のPython実行ファイルを直接指定してください：

{
  "mcpServers": {
    "velociraptor-dfir": {
      "command": "/path/to/repo/.venv/bin/python",
      "args": ["/path/to/repo/mcp_velociraptor_bridge.py"]
    }
  }
}

3. ネットワークデプロイ（Docker / SSE）

Open WebUI や n8n などのサーバーベースのプラットフォームでは、付属のDocker Compose構成を使用して、Server-Sent Events (SSE) 経由でローカルネットワーク上にMCPサーバーを公開できます。

セットアップ

このリポジトリは、FastMCP HTTPサーバーを利用してSSE RESTエンドポイントを提供します。

1. api_client.yaml と .env がルートディレクトリに配置されていることを確認します。

2. Dockerコンテナをビルドして起動します：

   docker compose up -d

3. サーバーには http://<your-host-ip>:8088/sse のSSE経由でアクセス可能になります。

⚠️ セキュリティおよび強化要件

**[!CAUTION] このMCPサーバーは、Velociraptor内で「管理者」権限で動作します。プロセスの終了、ファイルの取得、デプロイメント全体にわたる機密性の高いエンドポイントデータへのアクセスが可能です。

Dockerを使用してネットワーク経由でサーバーを公開する場合：

• ネイティブ認証なし: 組み込みのSSEサーバーは、堅牢なHTTP認証メカニズムを提供しません。

• 露出の低減: ポート 8088 をパブリックインターネットや信頼できないネットワークに公開しないでください。

• ネットワークプロキシ: コンテナの前にリバースプロキシ（Nginx、Traefikなど）を配置し、相互TLS (mTLS)、厳格なIP許可リスト、または同等のネットワークレベルの認証を強制する必要があります。トラフィックは、許可されたLLM消費ノードに明示的に制限されるべきです。

ドキュメント

サポートされているmacOS、Linux、Windowsのフォレンジックツール、設定の詳細、アーキテクチャ図の包括的なリストについては、包括的なドキュメントを参照してください。