Bugcrowd MCP

🚀 Bugcrowd MCP服務器

Bugcrowd MCP服務器項目提供了一個模型上下文協議（MCP）服務器，它將整個 Bugcrowd REST API 作為可調用工具暴露給大語言模型（LLMs）和自動化系統。該項目使用異步MCP SDK以Python語言實現，可與Claude Desktop、MCP Inspector或任何兼容的LLM代理配合使用。

🚀 快速開始

Bugcrowd MCP服務器可在大語言模型（如Claude、GPT等）與Bugcrowd平臺之間架起橋樑。它將每個Bugcrowd API端點作為工具暴露出來，讓你能夠：

• 查詢項目、提交內容、報告、資產、用戶等信息
• 在Bugcrowd上創建、更新或刪除資源
• 自動化漏洞管理和報告流程
• 將Bugcrowd數據集成到你自己的工作流、儀表盤或安全自動化系統中

所有API調用都是安全且異步進行的，並且不會硬編碼憑證。

✨ 主要特性

• 全面覆蓋Bugcrowd API：所有文檔化的端點都可作為MCP工具使用（GET、POST、PATCH、DELETE等）。
• 異步且可擴展：採用異步Python和 httpx 構建，具備高併發和響應能力。
• 安全可靠：憑證從環境變量中讀取，不會硬編碼。
• 易於集成：可直接與Claude Desktop或任何兼容MCP的客戶端配合使用。

📦 安裝指南

1. 安裝依賴項

本項目使用 uv 進行快速Python依賴管理：

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服務器

此服務器默認使用 標準輸入輸出傳輸（不啟動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.
# 使用MCP客戶端或LLM代理
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."}}})

影響

• 大語言模型和代理：現在可以安全地以編程方式與完整的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許可證。