Bugbounty MCP Server

🚀 Bug Bounty MCP Server

バグバウンティハンティングのワークフローとREST APIエンドポイントを備えた、クリーンで焦点の絞られたサーバーです。

🚀 クイックスタート

1. 依存関係のインストールとサーバーの起動

# uvで依存関係をインストール
uv sync

# 開発用の依存関係をインストール（オプション）
uv sync --dev

# プリコミットフックを設定（開発時に推奨）
uv run pre-commit install

# サーバーを起動
uv run src/server.py

# または環境変数を使用して起動
DEBUG=true BUGBOUNTY_MCP_PORT=8888 uv run src/server.py

# または起動スクリプトを使用
./start-server.sh --debug --port 8888

2. APIのテスト

# レコナッサンスワークフローを作成
curl -X POST http://127.0.0.1:8888/api/bugbounty/reconnaissance-workflow \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com", "program_type": "web"}'

✨ 主な機能

• クリーンなアーキテクチャ：コア機能を維持しながら、不必要な依存関係を削除しました。
• バグバウンティに特化：レコナッサンス、脆弱性探索、ビジネスロジックテスト、OSINT、ファイルアップロードテストなどの専用ワークフローが用意されています。
• REST APIエンドポイント：ワークフローの生成と管理を行うためのシンプルなHTTP APIが提供されます。
• 包括的な評価：複数のワークフローを組み合わせることで、完全なバグバウンティ評価が可能です。

🔧 技術詳細

コアコンポーネント

• REST APIサーバー (src/server.py) - バグバウンティワークフローエンドポイントを備えたFlaskベースのHTTP APIサーバー
• MCPサーバー (src/mcp_server.py) - AIエージェントとの通信を行うFastMCPベースのサーバー
• バグバウンティワークフロー - テストの各フェーズに特化したワークフロー生成
• ツール統合 - 包括的なセキュリティテストツールのコレクション

📦 インストール

環境変数

• BUGBOUNTY_MCP_PORT: サーバーのポート（デフォルト: 8888）
• BUGBOUNTY_MCP_HOST: サーバーのホスト（デフォルト: 127.0.0.1）
• DEBUG: デバッグモードを有効にする（デフォルト: false）

使用例

# デフォルト設定で起動
uv run src/server.py

# カスタム設定で起動
DEBUG=true BUGBOUNTY_MCP_PORT=9999 BUGBOUNTY_MCP_HOST=0.0.0.0 uv run src/server.py

✨ 主な機能の詳細

1. バグバウンティワークフロー管理：バグバウンティハンティングの各フェーズに対応した完全なワークフロー生成が可能です。
2. 脆弱性の優先順位付け：影響度とバウンティの可能性に基づいたインテリジェンス駆動型の優先順位付けが行われます。
3. ファイルアップロードテスト：ファイルアップロード脆弱性テストのための専用フレームワークが用意されています。
4. OSINT統合：包括的なOSINT収集ワークフローが提供されます。
5. ビジネスロジックテスト：ビジネスロジックの脆弱性発見に対する構造化されたアプローチが採用されています。

📦 依存関係

このプロジェクトでは、高速で信頼性の高い依存関係管理のためにuvを使用しています。

コア依存関係

• Flask：REST API用のWebフレームワーク
• FastMCP：MCPサーバーフレームワーク
• Requests：HTTPクライアントライブラリ
• Python 3.11+：コアランタイム（Python 3.11、3.12、3.13をサポート）

開発用依存関係

• Ruff：高速なPythonリンターとフォーマッター
• Bandit：セキュリティ脆弱性スキャナー
• Pydocstyle：ドキュメント品質チェッカー
• Pyright：静的型チェッカー
• Pre-commit：Gitのプリコミットフックフレームワーク

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

uv sync                # コア依存関係のみ
uv sync --dev         # 開発ツールも含める

新しい依存関係の追加：

uv add package-name

📚 コード品質

このプロジェクトでは、自動化されたプリコミットフックを通じてコード品質を保証しています。

# プリコミットフックのインストール
uv run pre-commit install

# すべてのファイルに対してチェックを実行
uv run pre-commit run --all-files

# 特定のチェックを実行
uv run ruff check          # リンティング
uv run ruff format         # フォーマット
uv run bandit -c pyproject.toml # セキュリティスキャン
uv run pydocstyle          # ドキュメントチェック

標準:

• 行の長さ: 88文字
• ドキュメント: Google docstring規約
• 型ヒント: パブリックAPIには必須
• セキュリティ: Banditセキュリティスキャンが有効化されています。