Burpsuite MCP Server

🛡️ BurpSuite MCP サーバー

強力なモデルコンテキストプロトコル (MCP) サーバーの実装で、BurpSuiteに適しており、Burpのコア機能へのプログラムによるアクセスを提供します。

🚀 クイックスタート

このBurpSuite MCPサーバーは、Burpのコア機能へのプログラムによるアクセスを提供する強力なツールです。以下に主な機能と使用方法を紹介します。

✨ 主な機能

🔄 プロキシツール

• HTTP/HTTPSトラフィックのインターセプトと修正
• リクエスト/レスポンスの表示と操作
• プロキシ履歴へのアクセス
• リアルタイムのリクエスト/レスポンス操作

# リクエストをインターセプトする
curl -X POST "http://localhost:8000/proxy/intercept" -H "Content-Type: application/json" -d '{"url":"https://example.com","method":"GET"}'

# プロキシ履歴を表示する
curl http://localhost:8000/proxy/history

# プロキシ履歴をクリアする
curl -X DELETE http://localhost:8000/proxy/clear

📝 ログ機能

• トラフィックデータの収集と分析
• 潜在的な脆弱性の検出
• セキュリティレポートの生成
• リアルタイムモニタリング

# リクエストを記録する
curl -X POST "http://localhost:8000/logger" -H "Content-Type: application/json" -d '{"endpoint":"/api/v1/login","method":"POST","body":{"username":"admin","password":"secret"}}'

# ログの概要を取得する
curl http://localhost:8000/logger-summary

# ログをエクスポートする
curl http://localhost:8000/export-logs

📊 分析機能

トラフィック分析

• 総リクエスト数の統計
• 一意のURLの統計
• HTTPメソッドの分布
• ステータスコードの分布
• コンテンツタイプの分析
• 平均レスポンス時間

脆弱性分析

• 脆弱性タイプの集計
• 重点的な脆弱エンドポイント
• 疑わしいパターンの識別
• リアルタイムの脆弱性検出

🔧 技術詳細

🔒 セキュリティに関する考慮事項

1. 安全な環境で実行する
2. 適切な認証を設定する
3. 本番環境ではHTTPSを使用する
4. BurpSuite APIキーを安全に保管する
5. アクセスの監視と監査を行う

📚 ドキュメント

詳細なAPIドキュメントは以下のURLからアクセスできます。

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

💻 使用例

基本的な使用法

Cursor IDEとの統合に関する情報です。MCPサーバーは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インタープリターが自動的に設定される

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

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

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細は LICENSE を参照してください。