Bugcrowd MCP

🚀 Bugcrowd MCP Server

このプロジェクトは、Model Context Protocol (MCP) サーバーを提供します。このサーバーは、Bugcrowd REST API 全体を、LLMや自動化ツールから呼び出せる形で公開します。Pythonで非同期MCP SDKを使用して実装されており、Claude Desktop、MCP Inspector、または互換性のある任意のLLMエージェントと一緒に使用できます。

🚀 クイックスタート

Bugcrowd MCP Serverは、ClaudeやGPTなどのLLMとBugcrowdプラットフォームの間の橋渡しとして機能します。BugcrowdのすべてのAPIエンドポイントをツールとして公開し、以下のことが可能になります。

• プログラム、提出物、レポート、資産、ユーザーなどをクエリする
• Bugcrowd上のリソースを作成、更新、または削除する
• 脆弱性管理とレポートを自動化する
• Bugcrowdのデータを独自のワークフロー、ダッシュボード、またはセキュリティ自動化に統合する

すべてのAPI呼び出しは安全かつ非同期に行われ、資格情報はハードコードされることはありません。

✨ 主な機能

• Bugcrowd APIの完全カバレッジ：ドキュメント化されているすべてのエンドポイントがMCPツールとして利用可能です（GET、POST、PATCH、DELETEなど）。
• 非同期かつスケーラブル：非同期Pythonとhttpxを使用して構築されており、高い並行性と応答性を備えています。
• セキュア：資格情報は環境変数から読み取られ、ハードコードされることはありません。
• 簡単な統合：Claude DesktopまたはMCP互換のクライアントですぐに使用できます。

📦 インストール

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

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

uv pip install -r requirements.txt

または、pyproject.tomlを使用している場合は、以下のコマンドを実行します。

uv pip install .

2. Bugcrowd APIの資格情報を設定する

Bugcrowd APIのユーザー名とパスワードを環境変数としてエクスポートします。

export BUGCROWD_API_USERNAME="your_username"
export BUGCROWD_API_PASSWORD="your_password"

⚠️ 重要提示

これらの環境変数が設定されていなくても、サーバーは起動し、利用可能なすべてのツールを表示します。ただし、資格情報が提供されるまで、Bugcrowd APIツールを呼び出そうとするとランタイムエラーが発生します。

3. MCPサーバーを起動する

このサーバーはデフォルトでstdioトランスポートを使用します（HTTPサーバーは起動されません）。これはClaude DesktopやほとんどのLLM統合に推奨されるモードです。

uv run server.py

4. Claude Desktopで設定する

Claude Desktopのmcpserver.json設定に以下を追加します（ディレクトリパスは必要に応じて調整してください）。

{
  "mcpServers": {
    "BugcrowdMCP": {
      "command": "uv",
      "args": [
        "--directory", "/Users/haji/mcp-servers/bugcrowd-mcp",
        "run", "server.py"
      ]
    }
  }
}

⚠️ 重要提示

HTTPサーバーは起動されません。すべての通信はstdio（標準入出力）を介して行われ、LLMツールとの最大限の互換性とセキュリティを確保します。

💻 使用例

基本的な使用法

サーバーが起動し、LLMまたはMCPクライアントに接続されたら、任意のBugcrowd APIエンドポイントをツールとして呼び出すことができます。たとえば、すべてのプログラムをリストするには、以下のようにします。

LLMまたはMCPクライアントへのプロンプト：

Call the tool `get_programs` to list all Bugcrowd programs I have access to.

ツール呼び出しの例（疑似コード）：

# Using an MCP client or LLM agent
result = call_tool("get_programs", {})
print(result)

必要に応じてクエリパラメータを渡すこともできます。

result = call_tool("get_programs", {"fields[program]": "name,code"})

特定のIDでプログラムを取得するには、以下のようにします。

result = call_tool("get_program", {"id": "PROGRAM_UUID"})

新しいレポートを作成するには、以下のようにします。

result = call_tool("post_reports", {"data": {"type": "report", "attributes": {"title": "Test Report", "description": "Example."}}})

高度な使用法

• LLMやエージェントは、安全かつプログラム的に完全なBugcrowd APIとやり取りできるようになり、自動化、レポート、および他のツールとの統合が可能になります。
• セキュリティチームは、脆弱性管理、レポート、およびBugcrowdからのデータ抽出を自動化できます。
• 開発者は、Bugcrowdのデータとアクションを利用するワークフローを、単一の標準化されたMCPインターフェイスから迅速にプロトタイプ化できます。

📚 ドキュメント

プロジェクト構造

• server.py — Bugcrowd APIエンドポイントをツールとして公開する主要なMCPサーバー。
• README.md — このドキュメント。
• pyproject.toml — プロジェクトの依存関係。

必要条件

• Python 3.10以上
• uv（実行と依存関係管理用）
• httpx（非同期HTTPリクエスト用）
• mcp（MCP Python SDK）

📄 ライセンス

MIT