Skip to content

browserstack/mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

20 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

BrowserStack MCP Server

BrowserStack Logo MCP Server Logo

See it in action, check out the video below.

Watch the video

πŸš€ Overview

BrowserStack MCP Server brings the power of BrowserStack's Test Platform directly into your development workflow. It enables you to run tests, debug applications, and perform cross-browser testing through any MCP-compliant client.

✨ Features - More Coming Soon!

πŸ“± App Testing

  • Real Device Testing: Test your mobile apps on BrowserStack's extensive cloud of real devices
  • Performance Testing: Unlike emulators, test your app's real-world performance on actual devices
  • Live Debugging: Debug crashes and performance issues in real-time
  • Comprehensive Device Coverage: Access all major devices and OS versions from our device grid

🌐 Web Testing

  • Local Testing: Seamlessly test websites hosted on localhost
  • Cross-Browser Testing: Test websites across different browsers and devices
  • Screenshot Testing: Capture and compare screenshots across different environments

πŸ§ͺ Automated Testing

  • Fix Test Failures: Leverage AI to identify and fix test failures reported by your CI/CD pipeline by utilising our industry leading Test Observability features. Find more info here.
  • Run on BrowserStack: Easily run tests written in Jest, Playwright, Selenium, and more on BrowserStack's Test Platform
  • Accessibility Testing: Ensure WCAG and ADA compliance with our Accessibility Testing tool

πŸ› οΈ Installation

  1. Create a BrowserStack Account

  2. Install the MCP Server

    • Sample MCP Server config for Cursor: .cursor/mcp.json:
    {
      "mcpServers": {
        "browserstack_mcp_server": {
          "command": "npx",
          "args": ["@browserstack/mcp-server"],
          "env": {
            "BROWSERSTACK_USERNAME": "",
            "BROWSERSTACK_ACCESS_KEY": ""
          }
        }
      }
    }
    • For Github Copilot users, ensure you are using the latest version of the VSCode with support for Copilot agent mode.

πŸ’‘ Usage Examples

App Testing

# Open app on specific device
"open my app on a iPhone 15 Pro Max"

# Debug app crashes
"My app crashed on Android 14 device, can you help me debug?"

Web Testing

# Test local website
"open my website hosted on localhost:3001 on a Windows Edge browser and take a screenshot"

# Check website compatibility
"open test.com on Samsung Browser and check for readability issues"

Automated Testing

# Run test suite
"run my test suite on BrowserStack"

# Debug test failures
"My test suite failed, can you help me fix the new failures?"

# Accessibility testing
"check for accessibility issues on my www.mywebsite.com"

🀝 Recommended MCP Clients

  • Github Copilot or Cursor (Recommended for automated testing + debugging)
  • Claude Desktop (Recommended for manual testing)

⚠️ Important Notes

  • The BrowserStack MCP Server is under active development and currently supports a subset of the MCP protocol, i.e. tools. More features will be added soon.
  • As tool invocation relies on the MCP Client which in turn rely on LLMs for tool calling. There can be some non-deterministic behaviour and can lead to unexpected results. If you have any suggestions or feedback, please open an issue to discuss.

πŸ“ Contributing

We welcome contributions! Please read our Contributing Guidelines for details on our code of conduct and the process for submitting pull requests.

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ“ž Support

For support, please:

πŸ”— Resources