Сервер MCP (Model Context Protocol), который предоставляет возможности отладки PHP через протокол DBGp Xdebug. Это позволяет помощникам ИИ, таким как Клод, напрямую отлаживать приложения PHP.

Особенности

###Основная отладка Полный контроль над отладкой: шаг в, шаг за шагом, шаг за шагом, шаг за шагом, продолжение, остановка Breakpoints: точки останова линии, условные точки останова, точки останова исключения, точки останова вызова функции ** Переменная инспекция**: просмотреть все переменные, получить конкретные переменные, установить переменные значения Оценка выражения: Оценка выражений PHP в текущем контексте Stack Traces: Смотреть полный стек вызовов Множественные сессии: отладка нескольких PHP-скриптов одновременно ** Поддержка хакеров** Работа с PHP в контейнерах Docker

Расширенные возможности

Посмотреть выражения: Постоянные часы, которые автоматически оценивают каждый перерыв с обнаружением изменений Logpoints: Лог-сообщения без остановки исполнения с использованием {$var} Профилирование памяти: отслеживание использования памяти и времени выполнения между точками останова Code Coverage: отслеживание, какие линии были выполнены во время отладки

Xdebug MCP Server

An MCP (Model Context Protocol) server that provides PHP debugging capabilities through Xdebug’s DBGp protocol. This allows AI assistants like Claude to directly debug PHP applications.

Features

Core Debugging

• Full Debug Control: Step into, step over, step out, continue, stop
• Breakpoints: Line breakpoints, conditional breakpoints, exception breakpoints, function call breakpoints
• Variable Inspection: View all variables, get specific variables, set variable values
• Expression Evaluation: Evaluate PHP expressions in the current context
• Stack Traces: View the full call stack
• Multiple Sessions: Debug multiple PHP scripts simultaneously
• Docker Support: Works with PHP running in Docker containers

Advanced Features

• Watch Expressions: Persistent watches that auto-evaluate on each break with change detection
• Logpoints: Log messages without stopping execution using {$var} placeholders
• Memory Profiling: Track memory usage and execution time between breakpoints
• Code Coverage: Track which lines were executed during debugging
• Request Context: Capture $_GET, $_POST, $_SESSION, $_COOKIE, headers automatically
• Step Filters: Skip vendor/library code during stepping
• Debug Profiles: Save and restore breakpoint configurations
• Session Export: Export debug sessions as JSON or HTML reports

Installation

From npm (Recommended)

npm install -g xdebug-mcp

From Source

git clone https://github.com/kpanuragh/xdebug-mcp.git
cd xdebug-mcp
npm install
npm run build

MCP Server Configuration

For Claude Code

Add the xdebug-mcp server to your MCP configuration (.mcp.json or Claude settings):

Using npm global install:

{
  "mcpServers": {
    "xdebug": {
      "command": "xdebug-mcp",
      "env": {
        "XDEBUG_PORT": "9003",
        "LOG_LEVEL": "info"
      }
    }
  }
}

Using npx:

{
  "mcpServers": {
    "xdebug": {
      "command": "npx",
      "args": ["-y", "xdebug-mcp"],
      "env": {
        "XDEBUG_PORT": "9003",
        "LOG_LEVEL": "info"
      }
    }
  }
}

With Path Mappings (for Docker)

When debugging PHP in Docker containers, you need path mappings to translate container paths to host paths:

{
  "mcpServers": {
    "xdebug": {
      "command": "xdebug-mcp",
      "env": {
        "XDEBUG_PORT": "9003",
        "PATH_MAPPINGS": "{\"/var/www/html\": \"/home/user/projects/myapp\"}",
        "LOG_LEVEL": "info"
      }
    }
  }
}

With DBGp Proxy Registration