MCP 服务器

BugBug MCP Server

Enables comprehensive interaction with the BugBug test automation platform through its API. Supports running tests, monitoring execution status, managing test suites, retrieving results and screenshots, and performing batch operations through natural language commands.

README

BugBug MCP Server

Unofficial MCP Server for BugBug

A Model Context Protocol (MCP) server implementation in TypeScript that provides comprehensive tools for BugBug test automation platform.

</div>

Features

Complete BugBug API Integration: Full access to tests, suites, runs, and profiles
Cross AI Assistant Support: Works with Claude, Windsurf, GitHub Copilot, and other AI assistants
Advanced Tools: Wait for completion, error explanation, and batch operations
Smart Test Running: Run tests by name or UUID with intelligent matching
Real-time Monitoring: Track test and suite execution with live status updates
Built with TypeScript: Type safety and modern development practices

Setup

Prerequisites

Node.js 18 or higher
BugBug account and API token

Adding to AI Assistants

Add to your MCP settings:

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

Available Tools

Advanced Tools

Tool Name	Description	Parameters
`wait_for_test_run`	Wait until test run finishes, return full results	`runId`, `timeoutMinutes?`, `pollIntervalSeconds?`
`wait_for_suite_run`	Wait until suite run finishes, return full results	`runId`, `timeoutMinutes?`, `pollIntervalSeconds?`
`explain_error`	Get error details and documentation	`runId`, `runType`
`show_run_from_last_24`	Show recent runs from last 24 hours	`runType?`, `pageSize?`
`run_test_by_name_or_id`	Run test by name or UUID with smart matching	`testNameOrId`, `profileName?`, `variables?`, `triggeredBy?`

Profiles

Tool Name	Description	Parameters
`get_profiles`	Get list of BugBug run profiles	`page?`, `pageSize?`
`get_profile`	Get details of a specific run profile	`profileId`

Tests

Tool Name	Description	Parameters
`get_tests`	Get list of BugBug tests	`page?`, `pageSize?`, `query?`, `ordering?`
`get_test`	Get details of a specific test	`testId`
`update_test`	Update a test (full update)	`testId`, `name`, `isActive`
`partial_update_test`	Partially update a test	`testId`, `name?`, `isActive?`

Test Suites

Tool Name	Description	Parameters
`get_suites`	Get list of test suites	`page?`, `pageSize?`, `query?`, `ordering?`
`get_suite`	Get details of a specific test suite	`suiteId`

Test Runs

Tool Name	Description	Parameters
`get_test_runs`	Get list of historical test runs	`page?`, `pageSize?`, `ordering?`, `startedAfter?`, `startedBefore?`
`get_test_run`	Get detailed results of a test run	`runId`
`get_test_run_status`	Get current status of a test run	`runId`
`get_test_run_screenshots`	Get screenshots from a test run	`runId`
`stop_test_run`	Stop a running test	`runId`

Suite Runs

Tool Name	Description	Parameters
`get_suite_run`	Get detailed results of a suite run	`runId`
`get_suite_run_status`	Get current status of a suite run	`runId`
`get_suite_run_screenshots`	Get screenshots from a suite run	`runId`
`stop_suite_run`	Stop a running suite	`runId`