JinDaGe - bugcrowd-mcp MCP Details

article

README

🚀 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许可证。

bugcrowd-mcp