HackerOne API连接服务

HackerOne MCP服务器是一个连接Claude、Codex和其他MCP客户端到HackerOne黑客API的中间件服务,支持报告管理、支付查询、程序信息获取等功能。

  • by alpernae
  • JavaScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 alpernae/hackerone-mcp

使用说明

HackerOne MCP服务器

将Claude、Codex和其他MCP客户端连接到HackerOne Hackers API的MCP(模型上下文协议)服务器。

可用工具

21个工具涵盖完整的Hacker API表面文档:

  • 黑客活动搜索
  • 报告:列表、获取和创建
  • 付款:余额、收益和支出
  • 程序:列表、获取、结构化范围、范围排除和弱点
  • 报表意图:列表、获取、创建、更新、删除、提交和附件管理

设置

1.安装依赖项

cd hackerone-mcp
npm install

2.获取您的HackerOne API证书

  1. 首选https://hackerone.com/settings/api_token/edit
  2. 创建新的API令牌
  3. 注意你的 用户名 以及生成的 令牌

配置

克劳德桌面版

编辑您的Claude Desktop配置文件:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "hackerone": {
      "command": "node",
      "args": ["/absolute/path/to/hackerone-mcp/index.js"],
      "env": {
        "HACKERONE_API_USERNAME": "your_api_token_identifier",
        "HACKERONE_API_TOKEN": "your_api_token"
      }
    }
  }
}

保存后重新启动Claude Desktop。


克劳德代码(CLI)

运行一次将MCP服务器添加到Claude Code配置中:

claude mcp add hackerone \
  -e HACKERONE_API_USERNAME=your_api_token_identifier \
  -e HACKERONE_API_TOKEN=your_api_token \
  -- node /absolute/path/to/hackerone-mcp/index.js

或者先将凭据设置为shell环境变量:

export HACKERONE_API_USERNAME=your_api_token_identifier
export HACKERONE_API_TOKEN=your_api_token

claude mcp add hackerone -- node /absolute/path/to/hackerone-mcp/index.js

验证它是否已注册:

claude mcp list

Codex CLI

运行一次将MCP服务器添加到Codex:

codex mcp add hackerone \
  --env HACKERONE_API_USERNAME=your_api_token_identifier \
  --env HACKERONE_API_TOKEN=your_api_token \
  -- node /absolute/path/to/hackerone-mcp/index.js

或者直接在中配置它 config.toml:

  • macOS/Linux: ~/.codex/config.toml
  • 窗户: %USERPROFILE%\.codex\config.toml
[mcp_servers.hackerone]
command = "node"
args = ["/absolute/path/to/hackerone-mcp/index.js"]

[mcp_servers.hackerone.env]
HACKERONE_API_USERNAME = "your_api_token_identifier"
HACKERONE_API_TOKEN = "your_api_token"

验证它是否已注册:

codex mcp list

在Codex TUI中,运行 /mcp 查看活动的MCP服务器。


其他MCP客户端(通用stdio)

启动时传递环境变量:

HACKERONE_API_USERNAME=your_api_token_identifier \
HACKERONE_API_TOKEN=your_api_token \
node /path/to/hackerone-mcp/index.js

或者使用以下内容配置客户的MCP设置:

  • 命令: node
  • args: ["/path/to/hackerone-mcp/index.js"]
  • 环境: { "HACKERONE_API_USERNAME": "...", "HACKERONE_API_TOKEN": "..." }

示例提示

连接后,您可以向您的MCP客户端(Claude、Codex等)询问以下内容:

  • “列出我的HackerOne报告”
  • “搜索Hacktivity以获取已披露的关键报告”
  • “获取报告12345的完整详细信息”
  • “nodejs程序的作用域是什么?”
  • “显示安全计划的政策和赏金信息”
  • “列出我有权访问的所有程序”

安全说明

  • 从不硬编码 源文件中的API令牌
  • 始终使用环境变量或客户的机密管理器
  • 您的API代币提供对HackerOne帐户的完全访问-将其视为密码

可靠性设置(可选)

如果您看到间歇性故障(超时、429速率限制、瞬态5xx),您可以调整这些环境变量:

  • HACKERONE_TIMEOUT_MS (默认值: 20000)--每次请求超时
  • HACKERONE_MAX_RETRIES (默认值: 2)--重试429/5xx和瞬态网络错误
  • HACKERONE_API_BASE (默认值: https://api.hackerone.com/v1)-API基本URL