xdebug — MCP-сервер для Claude Code: отладка PHP
Подключает отладчик Xdebug к агенту: брейкпоинты, шаг за шагом, просмотр переменных и стека прямо из чата. Пригодится, когда PHP-скрипт падает необъяснимо.
claude mcp add xdebug -- npx -y xdebug-mcpЧто делает xdebug
Сервер говорит с Xdebug по протоколу DBGp. Агент может поставить строковый или условный брейкпоинт, пройти вглубь, перепрыгнуть функцию, выйти из неё и остановить сессию. Значения переменных видно и можно менять, выражения PHP считаются в текущем контексте.
Внутри больше сорока инструментов: кроме базовой отладки есть watch-выражения, логпоинты с подстановкой {$var}, замер памяти и времени между остановками, покрытие строк, снимок $_GET, $_POST, $_SESSION и заголовков. Сессии переключаются, а шаг можно настроить так, чтобы он не заходил в код вендоров. Отлаживать PHP в Docker сервер умеет, если задать PATH_MAPPINGS — без них пути контейнера не совпадут с хостовыми. Порт по умолчанию 9003, его же надо прописать в xdebug.client_port; в контейнере адрес хоста задаётся через host.docker.internal. Вместо TCP можно слушать Unix-сокет через XDEBUG_SOCKET_PATH, это быстрее для локальной отладки.
Какие задачи решает
- поймать момент, когда переменная получает не то значение
- пройти по вызову и увидеть весь стек
- остановиться на нужном исключении, а не на каждом
- замерить память и время между двумя точками кода
- посмотреть, какие строки реально выполнились
Примеры запросов агенту
- Поставь брейкпоинт в
src/Order.phpна строке 84 и запусти отладку - Покажи все переменные в текущей сессии xdebug
- Добавь watch-выражение на
$totalи остановись, когда оно изменится
Как установить xdebug
Командой платформы
claude mcp add xdebug -- npx -y xdebug-mcpКомандой платформы
codex mcp add xdebug -- npx -y xdebug-mcpФайл настроек
{
"mcpServers": {
"xdebug": {
"command": "npx",
"args": [
"-y",
"xdebug-mcp"
]
}
}
}Файл настроек
{
"servers": {
"xdebug": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xdebug-mcp"
]
}
}
}Командой платформы
gemini mcp add xdebug npx -y xdebug-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о xdebug
Как установить xdebug в Claude Code?
Одной командой: claude mcp add xdebug -- npx -y xdebug-mcp. После этого проверьте настройки PHP, чтобы Xdebug стучался на порт 9003.
Что делает xdebug?
Соединяет агента с Xdebug по DBGp и даёт инструменты отладки: брейкпоинты, пошаговое выполнение, переменные, стек, вычисление выражений.
Что нужно настроить в PHP?
В php.ini включите xdebug.mode=debug, укажите xdebug.client_port=9003 и адрес хоста, где слушает сервер. В Docker для Linux понадобится host.docker.internal и extra_hosts.
