X3r0k BurpSuite MCP Server

🛡️ BurpSuite MCP サーバー

強力なモデルコンテキストプロトコル（MCP）サーバーの実装で、BurpSuiteに適用され、Burpの核心機能へのプログラムによるアクセスを提供します。

🚀 クイックスタート

このサーバーは、BurpSuiteの機能をプログラムで利用できるようにするためのものです。以下のセクションでは、機能、インストール方法、使い方などについて詳しく説明します。

✨ 主な機能

🔄 プロキシツール

• HTTP/HTTPSトラフィックをインターセプトして変更する
• リクエスト/レスポンスを表示して操作する
• プロキシ履歴にアクセスする
• リクエスト/レスポンスをリアルタイムでインターセプトする

🔍 スキャナー

• 脆弱性スキャン：webアプリケーション内のSQLインジェクションやXSSなどの一般的なセキュリティ脆弱性を自動的に識別します。
• クローラー機能：対象ウェブサイトを深く探索し、隠されたリンクやリソースを発見します。
• パッシブスキャン：攻撃を行わずに潜在的なセキュリティ問題を検出します。

📊 ログ記録

• すべてのネットワークトラフィックをリアルタイムで監視して記録する
• ログのフィルタリングと検索機能をサポートする
• 詳細なアクセスログ分析を提供する

💡 脆弱性検出

• ディレクトリトラバーサルやファイルインクルードなどの一般的なweb脆弱性を自動的に識別する
• 脆弱性の優先度を並べ替える機能を提供する
• 詳細な脆弱性レポートを生成する

📦 インストール

1. 依存関係のインストール：

   • Python 3.8以上
   • FastAPIとその他の関連ライブラリ

2. 環境設定：

   • BurpSuite APIキーを設定する
   • プロキシサーバーのアドレスとポートを設定する
   • ログの保存パスを設定する

💻 使用例

基本的な使用法

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

git clone https://github.com/yourusername/burpsuite-mcp.git
cd burpsuite-mcp

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

pip install -r requirements.txt

3. サーバーを起動します：

uvicorn main:app --reload

4. ドキュメントにアクセスします：
   • Swagger UI：http://localhost:8000/docs
   • ReDoc：http://localhost:8000/redoc

🛡️ セキュリティに関する注意事項

1. 安全な環境で実行する
2. 適切な認証機構を設定する
3. 本番環境ではHTTPSを使用する
4. BurpSuite APIキーを保護する
5. アクセスログを監視して監査する

📚 ドキュメント

Cursor IDE との統合

このプロジェクトは、Cursor IDEとシームレスに連携するように構成されています。.cursor フォルダには、すべての必要な設定ファイルが含まれています。

設定ファイル

1. settings.json：MCPサーバーの設定

   • サーバーのホストとポートの設定
   • エンドポイントの設定
   • BurpSuiteプロキシの設定
   • ログ記録の設定
   • Pythonインタープリターのパス

2. tasks.json：一般的なタスクを定義する

   • MCPサーバーを起動する
   • 脆弱性テストを実行する
   • 脆弱性をチェックする

3. launch.json：デバッグ設定を含む

   • MCPサーバーをデバッグする
   • 脆弱性テストをデバッグする

Cursor での使用方法

1. Cursorでプロジェクトを開く
2. MCPサーバーの設定が自動的に読み込まれる
3. 以下の方法で機能にアクセスする：
   • コマンドパネル（Ctrl+Shift+P）でタスクを実行する
   • デバッグメニューでデバッグセッションを開始する
   • Pythonインタープリターが自動的に設定される

MCPサーバーは http://localhost:8000 で利用可能です。主なエンドポイントは以下の通りです：

• /proxy/intercept：リクエストのインターセプト
• /logger：ログ機能
• /logger/vulnerabilities/severity：脆弱性分析

📄 ライセンス

このプロジェクトはMIT Licenseを使用しています。詳細は LICENSE ファイルを参照してください。

🙏 謝辞

• BurpSuite - 元のセキュリティテストツール
• FastAPI - 使用しているWebフレームワーク
• Python - 使用しているプログラミング言語