AI-Debug MCP Server

🔒 Compiled version - source code available with license

🚀 Quick Install

npm install -g ai-debug-local-mcp

🤖 Automated Setup (Recommended)

We provide automated setup scripts for all major AI coding environments:

Claude Code / Claude Desktop

# Global setup (all projects)
npx ai-debug-setup claude

# OR project-specific setup (recommended)
cd /path/to/your/project
npx ai-debug-setup project

Note: Claude Code (claude.ai/code) and Claude Desktop are the same application

Cursor

# Run the automated setup
npx ai-debug-setup cursor

Windsurf

# Run the automated setup  
npx ai-debug-setup windsurf

All Environments

# Setup for all supported environments
npx ai-debug-setup all

📝 Manual Setup Instructions

Claude Code / Claude Desktop

Option 1: Global Setup (All Projects)

1. Find your Claude config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add AI-Debug to your config:

{
  "mcpServers": {
    "ai-debug": {
      "command": "ai-debug-mcp",
      "args": []
    }
  }
}

3. Restart Claude Desktop

4. Verify installation:

// In Claude Code, run:
await get_current_mode()

Option 2: Project-Specific Setup (Recommended)

1. Navigate to your project:

cd /path/to/your/project

2. Create project config:

mkdir -p .claude
cat > .claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "ai-debug": {
      "command": "ai-debug-mcp",
      "args": []
    }
  }
}
EOF

3. Open the project in Claude Code
   • AI-Debug will be available only for this project
   • Can be committed to version control to share with team

Cursor

1. Open Cursor settings:

   • Press Cmd+, (Mac) or Ctrl+, (Windows/Linux)
   • Search for "MCP" or "Model Context Protocol"

2. Add AI-Debug configuration:

{
  "mcp.servers": {
    "ai-debug": {
      "command": "ai-debug-mcp",
      "args": []
    }
  }
}

3. Restart Cursor

Windsurf

1. Open Windsurf preferences:

   • Go to Preferences → Extensions → MCP

2. Add new MCP server:

   • Name: ai-debug
   • Command: ai-debug-mcp
   • Arguments: (leave empty)

3. Save and restart Windsurf

🎯 Quick Start Guide

Understanding Modes

AI-Debug offers three operation modes:

1. Direct Mode (Default)

   • Access to all 346+ individual debugging tools
   • Full control and detailed output
   • Best when you know exactly what you need

2. Orchestrator Mode

   • 9 high-level orchestrators that automate complex workflows
   • Best for exploring issues when you're not sure where to start

3. Hybrid Mode (Recommended)

   • Both orchestrators and essential tools
   • Best balance of automation and control

Basic Usage

// Check current mode
await get_current_mode()

// Switch modes
await switch_mode({ mode: "hybrid" })

// Start debugging a website
const session = await inject_debugging({ 
  url: "http://localhost:3000" 
})

// Take a screenshot
await take_screenshot({ sessionId: session.sessionId })

// Get console logs
await get_console_logs({ sessionId: session.sessionId })

// Run comprehensive audit
await run_audit({ sessionId: session.sessionId })

Using Orchestrators

// Debug a specific issue
await debug_orchestrator({ 
  task: "Find why the login button doesn't work",
  url: "http://localhost:3000/login"
})

// Performance analysis
await performance_orchestrator({
  task: "Analyze and optimize page load time",
  url: "http://localhost:3000"
})

// Accessibility audit
await accessibility_orchestrator({
  task: "Check WCAG compliance",
  url: "http://localhost:3000"
})

🛠️ Troubleshooting

AI-Debug not showing up?

1. Verify installation:

which ai-debug-mcp
# Should show: /usr/local/bin/ai-debug-mcp or similar

2. Check if command works:

ai-debug-mcp --version

3. For Claude Desktop, check logs:
   • Open Developer Console: Cmd+Option+I (Mac) or Ctrl+Shift+I (Windows)
   • Look for MCP-related errors

Common Issues

"command not found"

• Ensure npm global bin is in your PATH
• Try using the full path in config

"Error: Playwright not installed"

# Install browser dependencies
npx playwright install chromium

"Permission denied"

# Fix permissions
chmod +x $(which ai-debug-mcp)

🔒 License

This is a compiled version of AI-Debug. For source code access or commercial licensing, contact: ai-debug@rabbitfound.com

© 2025 Rabbit Found. All rights reserved.