Joesandboxmcp

🚀 Joe Sandbox MCP Server

Joe Sandbox MCP Serverは、Joe Sandbox Cloud とのやり取りを可能にするModel Context Protocol (MCP) サーバーです。このサーバーは、Joe Sandboxの豊富な分析とIOC抽出機能を公開し、任意のMCP互換アプリケーション（例：Claude Desktop、Glama、またはカスタムLLMエージェント）にシームレスに統合できます。

✨ 主な機能

• 柔軟な提出: ローカルファイル、リモートURL、ウェブサイト、またはコマンドラインを動的分析のために提出できます。
• IOC抽出: ドロップされたファイル、IP、ドメイン、およびURLの攻撃指標を取得できます。
• シグネチャ検出: サンドボックスシグネチャから実行可能な証拠を取得し、抽出できます。
• プロセスツリー: コマンドラインや親子関係を含む完全な実行階層を可視化できます。
• アンパックされたPEファイル: 実行中に抽出されたメモリ内のアンパックされたバイナリをダウンロードでき、多くの場合、ランタイムペイロードが明らかになります。
• PCAPダウンロード: 分析中に記録された完全なネットワークトラフィックキャプチャ (PCAP) を取得し、オフラインで検査できます。
• LLMに適したレスポンス: すべての結果は、言語モデルが明確に消費できるように構造化されており、切り捨てと関連するフィルタリングが行われています。

🚀 クイックスタート

uv を使用したインストール (推奨)

1. リポジトリをクローンします:

   git clone https://github.com/joesecurity/joesandboxMCP.git
   cd joesandboxMCP
   

2. uv を使用して依存関係をインストールします:

   uv venv
   uv pip install -e .
   

3. MCPサーバーを起動します (以下の設定を参照)

📚 ドキュメント

設定例

{
  "mcpServers": {
    "JoeSandbox": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/joesandboxMCP",
        "run",
        "main.py"
      ],
      "env": {
        "JBXAPIKEY": "your-jbxcloud-apikey",
        "ACCEPTTAC": "SET_TRUE_IF_YOU_ACCEPT"
      }
    }
  }
}

法的通知

このJoe Sandbox Cloudとの統合を使用するには、Joe Securityの利用規約に同意する必要があります。

環境変数 ACCEPTTAC=TRUE を設定することで、あなたは明示的に 利用規約 を読み、同意したことを確認します。

利用可能なツール

Joe Sandbox MCPサーバーは、サンドボックスレポートとのやり取り、実行の監視、および大規模言語モデルが理解しやすい形式での脅威インテリジェンスの抽出を支援する幅広いツールを提供します。

1. 分析の提出: ファイル、URL、ウェブサイト、またはコマンドラインをサンドボックス分析のために提出できます。結果を待つか、すぐに戻り、後で確認するかを選択できます。インターネットアクセス、スクリプトロギング、アーカイブパスワードなどのさまざまなオプションをサポートしています。
2. 過去の分析の検索: ハッシュ、ファイル名、検出ステータス、脅威名などを使用して過去の提出を検索できます。すでに分析されたものをすばやく見つけることができます。
3. 提出ステータスの確認: 以前に提出したサンプルの現在のステータスと主要なメタデータを取得できます。検出判定、使用されたシステム、および分析スコアが含まれます。
4. AI要約: サンドボックスのAIによって生成された高レベルの推論ステートメントを取得できます。複雑な動作を平易な言葉で理解するのに役立ちます。
5. 悪意のあるドロップファイル: 実行中にドロップされ、悪意があるとマークされたファイルを確認できます。ハッシュ値、ファイル名、オリジンプロセス、および検出指標が含まれます。 6–8. ネットワーク指標: 分析中に接触したドメイン、IPアドレス、またはURLを表示できます。明らかに悪意のある項目または高信頼度の検出のみに焦点を絞るようにフィルタリングできます。IP解決、地理的ヒント、通信コンテキスト、および検出証拠などの詳細が含まれます。
6. 動作検出 (シグネチャ): 実行中にトリガーされた主要な動作検出の概要を取得できます。高影響の項目のみに焦点を絞るようにフィルタリングできます。
7. プロセスツリー: 実行中に実行されたプロセスの完全な階層を可視化できます。親子関係、コマンドライン、および終了情報が表示されます。
8. アンパックされたバイナリ: メモリ内でアンパックまたは復号化された実行可能ファイルを取得できます。元のファイルでは見えないペイロードを特定するのに便利です。
9. ネットワークトラフィック (PCAP): 分析中に記録された完全なネットワークパケットキャプチャをダウンロードできます。トラフィック検査、C2コールバック、またはドメイン/IP抽出に役立ちます。
10. 最近のアクティビティ: 最近のサンドボックス提出を一覧表示し、どのシステムで実行されたか、どのようなスコアが付けられたか、どのような判定が返されたかを確認できます。
11. メモリダンプ: 実行時にキャプチャされた生のメモリダンプを取得できます。
12. ドロップされたファイル: 分析中にドロップされたすべてのファイルを取得できます。

📄 ライセンス

このプロジェクトは MITライセンス の下でライセンスされています。