bugbug-mcp-server

🚀 BugBug MCP Server

BugBug MCP Server 是一个用 TypeScript 实现的非官方模型上下文协议（MCP）服务器，为 BugBug 测试自动化平台提供了全面的工具。

🚀 快速开始

前提条件

• Node.js 18 或更高版本
• BugBug 账户和 API 令牌

添加到 AI 助手

将以下内容添加到你的 MCP 设置中：

{
  "mcpServers": {
    "bugbug": {
      "command": "npx",
      "args": ["-y", "@simplypixi/bugbug-mcp-server@latest"],
      "env": {
        "API_KEY": "your_bugbug_api_token_here"
      }
    }
  }
}

✨ 主要特性

• 完整的 BugBug API 集成：可全面访问测试、测试套件、测试运行和配置文件。
• 跨 AI 助手支持：可与 Claude、Windsurf、GitHub Copilot 等 AI 助手配合使用。
• 高级工具：支持等待完成、错误解释和批量操作。
• 智能测试运行：可通过名称或 UUID 智能匹配运行测试。
• 实时监控：实时跟踪测试和测试套件的执行状态。
• 基于 TypeScript 构建：具备类型安全和现代开发实践。

📚 详细文档

可用工具

高级工具

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | wait_for_test_run | 等待测试运行完成并返回完整结果 | runId, timeoutMinutes?, pollIntervalSeconds? | | wait_for_suite_run | 等待测试套件运行完成并返回完整结果 | runId, timeoutMinutes?, pollIntervalSeconds? | | explain_error | 获取错误详情和文档 | runId, runType | | show_run_from_last_24 | 显示最近 24 小时内的运行记录 | runType?, pageSize? | | run_test_by_name_or_id | 通过名称或 UUID 智能匹配运行测试 | testNameOrId, profileName?, variables?, triggeredBy? |

配置文件

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_profiles | 获取 BugBug 运行配置文件列表 | page?, pageSize? | | get_profile | 获取特定运行配置文件的详细信息 | profileId |

测试

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_tests | 获取 BugBug 测试列表 | page?, pageSize?, query?, ordering? | | get_test | 获取特定测试的详细信息 | testId | | update_test | 完整更新一个测试 | testId, name, isActive | | partial_update_test | 部分更新一个测试 | testId, name?, isActive? |

测试套件

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_suites | 获取测试套件列表 | page?, pageSize?, query?, ordering? | | get_suite | 获取特定测试套件的详细信息 | suiteId |

测试运行

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_test_runs | 获取历史测试运行列表 | page?, pageSize?, ordering?, startedAfter?, startedBefore? | | get_test_run | 获取测试运行的详细结果 | runId | | get_test_run_status | 获取测试运行的当前状态 | runId | | get_test_run_screenshots | 获取测试运行的截图 | runId | | stop_test_run | 停止正在运行的测试 | runId |

套件运行

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_suite_run | 获取套件运行的详细结果 | runId | | get_suite_run_status | 获取套件运行的当前状态 | runId | | get_suite_run_screenshots | 获取套件运行的截图 | runId | | stop_suite_run | 停止正在运行的套件 | runId |

配置

| 工具名称 | 描述 | 参数 | | ---- | ---- | ---- | | get_ip_addresses | 获取 BugBug 基础设施的 IP 地址列表 | 无 |