🚀 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 地址列表 |
无 |
