Skip to content

Home

Jump to bottom
Anuragh K P edited this page Mar 23, 2026 · 4 revisions

Xdebug MCP Server Wiki

Welcome to the Xdebug MCP Server documentation! This wiki provides comprehensive information about Xdebug, the Xdebug MCP Server, and how to use it for PHP debugging.

📖 Table of Contents

🚀 Getting Started (Start Here)

  1. Agent Integration ⭐ - Use xdebug-mcp with Claude, Cursor, Cline, VS Code, Copilot, Windsurf, PhpStorm, and more
  2. Getting Started - Installation and basic setup
  3. Debugging Guide - How to debug PHP applications

📚 Reference & Configuration

  1. Configuration Reference - All configuration options
  2. Tools & Commands - Available debugging tools
  3. Connection Modes - TCP vs Unix Domain Sockets
  4. Troubleshooting - Common issues and solutions

🔬 Technical Deep Dives (Advanced)

  1. Understanding Xdebug - What is Xdebug and how it works
  2. DBGp Protocol - The debugging protocol used by Xdebug
  3. MCP Server Architecture - How the Xdebug MCP Server works

🚀 Quick Start

npm install -g xdebug-mcp
xdebug-mcp

The server will start and listen for Xdebug connections. Use with Claude or any MCP client to debug PHP code.

📌 Quick Navigation

Using xdebug-mcp with an AI Agent or IDE? ⭐ Start here:

  • Agent Integration - Complete setup for your tool (Claude, Cursor, Cline, VS Code, Copilot, Windsurf, PhpStorm, etc.)

Setting up for the first time?

  1. Getting Started - Install and configure (5 minutes)
  2. Agent Integration - Connect with your agent (5 minutes)
  3. Debugging Guide - Learn debugging workflows (10 minutes)

Troubleshooting & Configuration:

Advanced Topics:

💡 What is Xdebug?

Xdebug is a powerful PHP extension that provides debugging and profiling capabilities. It allows developers to:

  • Set breakpoints and pause execution
  • Inspect variables and stack traces
  • Step through code line by line
  • Generate profiling reports
  • Collect code coverage metrics

🔗 Resources

Clone this wiki locally