Bugbug MCP Server

An unofficial MCP service implementation for the BugBug test platform, providing complete API integration and test management tools

Developer tools Monitoring #Test automation #API integration #Real-time monitoring #Intelligent running .TypeScript

rating : 2 points

downloads : 6.6K

update time : 2025-08-19

Open Site

What is BugBug MCP Server?

BugBug MCP Server is a Model Context Protocol (MCP) server implementation designed for the BugBug test automation platform, developed using TypeScript. It provides comprehensive API integration with the BugBug platform, enabling AI assistants to directly interact with the test automation system.

How to use BugBug MCP Server?

Configure the MCP settings of the AI assistant, add BugBug MCP Server as the service endpoint, and provide your BugBug API key. After that, the AI assistant can interact with the BugBug platform through the predefined toolset.

Applicable scenarios

Suitable for scenarios where you need to manage the BugBug test automation platform through an AI assistant, including test run monitoring, result query, error diagnosis, and batch operations.

Main features

Complete BugBug API integration

Provides comprehensive access to tests, suites, runs, and configuration files

Cross-AI assistant support

Compatible with various AI assistants such as Claude, Windsurf, and GitHub Copilot

Intelligent test running

Supports running tests by name or UUID with intelligent matching capabilities

Real-time monitoring

Provides real-time status updates for test and suite executions

Advantages

Simplifies the integration of AI assistants with the BugBug platform

Provides a rich toolset covering the entire test automation process

TypeScript implementation ensures type safety and modern development practices

Supports multiple mainstream AI assistants

Limitations

Requires a Node.js 18 or higher runtime environment

Must have a BugBug account and API token

Unofficial implementation, there may be a risk of out-of-sync with official API changes

How to use

Install Node.js

Ensure that Node.js 18 or a higher version is installed on the system

Configure the AI assistant

Add the BugBug MCP Server configuration to the MCP settings of the AI assistant

Verify the connection

Send a simple query through the AI assistant to verify if the connection is successful

Usage examples

Monitor test runs

Monitor the running status of a test in real-time after starting it until completion

Error diagnosis

Get detailed error explanations when a test fails

Batch operations

Get the status of all test suites at once

Frequently Asked Questions

How to get the BugBug API key?

Which AI assistants are supported?

What if the test run times out?

How to update to the latest version?

Related resources

BugBug official website

Official website of the BugBug test automation platform

GitHub repository

Source code of BugBug MCP Server

Node.js download

Official website of Node.js

🚀 BugBug MCP Server

An unofficial MCP Server for BugBug, offering a Model Context Protocol (MCP) server implementation in TypeScript, which provides comprehensive tools for the BugBug test automation platform.

✨ Features

Complete BugBug API Integration: Gain full access to tests, suites, runs, and profiles.
Cross AI Assistant Support: Compatible with Claude, Windsurf, GitHub Copilot, and other AI assistants.
Advanced Tools: Wait for completion, explain errors, and perform batch operations.
Smart Test Running: Run tests by name or UUID with intelligent matching.
Real-time Monitoring: Track the execution of tests and suites with live status updates.
Built with TypeScript: Ensure type safety and follow modern development practices.

📦 Installation

Prerequisites

Node.js 18 or higher
BugBug account and API token

Adding to AI Assistants

Add the following to your MCP settings:

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

💻 Usage Examples

Available Tools

Advanced Tools

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

Profiles

Property	Details
`get_profiles`	Get a list of BugBug run profiles. Parameters: `page?`, `pageSize?`
`get_profile`	Get details of a specific run profile. Parameters: `profileId`

Tests

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

Test Suites

Property	Details
`get_suites`	Get a list of test suites. Parameters: `page?`, `pageSize?`, `query?`, `ordering?`
`get_suite`	Get details of a specific test suite. Parameters: `suiteId`

Test Runs

Property	Details
`get_test_runs`	Get a list of historical test runs. Parameters: `page?`, `pageSize?`, `ordering?`, `startedAfter?`, `startedBefore?`
`get_test_run`	Get detailed results of a test run. Parameters: `runId`
`get_test_run_status`	Get the current status of a test run. Parameters: `runId`
`get_test_run_screenshots`	Get screenshots from a test run. Parameters: `runId`
`stop_test_run`	Stop a running test. Parameters: `runId`

Suite Runs

Property	Details
`get_suite_run`	Get detailed results of a suite run. Parameters: `runId`
`get_suite_run_status`	Get the current status of a suite run. Parameters: `runId`
`get_suite_run_screenshots`	Get screenshots from a suite run. Parameters: `runId`
`stop_suite_run`	Stop a running suite. Parameters: `runId`