The Debugg AI MCP Server is an AI-driven browser automation and end-to-end testing tool that offers:
Natural Language Testing: Run UI tests by describing features or flows in plain language
Local Application Support: Test web applications running on
localhost
portsMCP Protocol Integration: Seamlessly connect with AI agents and MCP-compatible clients
Real-Time Updates: Receive step-by-step notifications during test execution
Visual Verification: Capture screenshots of the final page state
Zero Configuration: Eliminate the need for local browser or Playwright setup
CI/CD Compatibility: Access historical test results for pipeline integration
Secure Remote Execution: Use managed browsers via secure tunnels
Deployment Options: Quick setup via NPX or Docker for local and remote use
Provides Docker container deployment option for running the MCP server with configurable environment variables
Integrates with GitHub repositories for testing web applications, with support for specifying repo name and branch information
Compatible with LangChain agents as MCP clients for browser automation and end-to-end testing
Available as an npm package (@debugg-ai/debugg-ai-mcp) for easy installation and integration
🧪 Official MCP Server for Debugg AI
AI-powered development and testing toolkit implementing the Model Context Protocol (MCP), designed to give AI agents comprehensive testing, debugging, and code analysis capabilities.
Transform your development workflow with:
- Zero-config E2E testing - Run browser tests with natural language descriptions
- Live session monitoring - Real-time browser console, network, and screenshot monitoring
- Test suite management - Create and manage comprehensive test suites
- Seamless CI/CD integration - View all test results in your Debugg.AI App dashboard
🚀 Features
12 Focused Development Tools
- 🧪 E2E Testing Suite - Run browser tests, create test suites, and generate commit-based tests
- 🖥️ Live Session Monitoring - Real-time browser console, network traffic, and screenshot monitoring
- 📊 Test Management - List, create, and track test suites and commit-based test suites
- 📱 Real-time Progress - Live updates with screenshots and step-by-step execution
- 🌐 Universal Compatibility - Works with any MCP-compatible client (Claude Desktop, LangChain, etc.)
Examples
Input prompt: "Test the ability to create an account and login"
Results:
Full Demo:
Watch a more in-depth, Full Use Case Demo
🛠️ Quick Setup
1. Get Your API Key
Create a free account at debugg.ai and generate your API key.
2. Choose Your Installation Method
Option A: NPX (Recommended)
Option B: Docker
🧰 Available Tools
E2E Testing Tools
debugg_ai_test_page_changes
- Run browser tests with natural language descriptionsdebugg_ai_create_test_suite
- Create organized test suites for featuresdebugg_ai_create_commit_suite
- Generate tests based on git commitsdebugg_ai_get_test_status
- Monitor test execution and results
Test Management Tools
debugg_ai_list_tests
- List all E2E tests with filtering and paginationdebugg_ai_list_test_suites
- List all test suites with filtering optionsdebugg_ai_list_commit_suites
- List all commit-based test suites
Live Session Monitoring Tools
debugg_ai_start_live_session
- Start a live browser session with real-time monitoringdebugg_ai_stop_live_session
- Stop an active live sessiondebugg_ai_get_live_session_status
- Get the current status of a live sessiondebugg_ai_get_live_session_logs
- Retrieve console and network logs from a live sessiondebugg_ai_get_live_session_screenshot
- Capture screenshots from an active live session
⚙️ Configuration
For Claude Desktop
Add this to your MCP settings file:
Optional Environment Variables
💡 Usage Examples
Run a Quick E2E Test
Analyze Your Project
Get Issue Insights
Generate Test Coverage
🧑💻 Local Development
📁 Project Structure
🚀 Publishing & Releases
This project uses automated publishing to NPM. Here's how it works:
Automatic Publishing
- Every push to
main
triggers automatic NPM publishing - Only publishes if the version doesn't already exist
- Includes full test suite validation and build verification
Version Management
Manual Version Bump via GitHub
- Go to Actions → Version Bump
- Click "Run workflow"
- Select version type or enter custom version
- Workflow will update version and trigger publish
Setup for Contributors
See .github/PUBLISHING_SETUP.md
for complete setup instructions.
💬 Support & Links
- 📖 Documentation: debugg.ai/docs
- 🐛 Issues: GitHub Issues
- 💬 Discord: Join our community
- 🌐 Dashboard: app.debugg.ai
🔒 License
Apache-2.0 License © 2025 DebuggAI
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Debugg AI MCP
Related MCP Servers
- MIT License
- MIT License
- MIT License
- MIT License