Debug PHP with Runtime Data — No var dump(), No Guesswork

Отладка на основе трека для PHP, построенная на Xdebug. Управляйте инструментами из CLI или позвольте помощнику AI запускать основные инструменты через плагин, Skill или интеграцию MCP.

-Нет-красный

Отладка естественного языка

Просто скажите своему помощнику, что вы хотите:

** Английский:**

***: **

При подключении через плагин, Skill или MCP-клиент ИИ может выбрать соответствующий инструмент, выполнить его и проанализировать результаты.

Требования

PHP 8.2+

• Расширение Xdebug 3.x (установлено, но **не включено по умолчанию) Опционально: помощник ИИ (плагин Claude Code, Codex Skill или любой клиент с поддержкой MCP)

Совет по производительности: ** Держите Xdebug отключенным в php.ini для ежедневного использования. Этот инструмент загружает Xdebug по требованию только при необходимости.

Быстрый старт

###1 Установить

###2 Проверить Xdebug

###3. (необязательно) Подключить помощника ИИ

Доступны две интеграции. ** Мы рекомендуем Skill**: эти инструменты представляют собой команды CLI без состояния по дизайну, поэтому позволить агенту запускать их напрямую - руководствуясь заметками об использовании Skill - это самый простой и самый точный путь.

Xdebug MCP

Debug PHP with Runtime Data — No var_dump(), No Guesswork

Trace-based debugging for PHP, built on Xdebug. Drive the tools from the CLI, or let an AI assistant run the core tools through plugin, Skill, or MCP integration.

---

Natural Language Debugging

Just tell your AI assistant what you want:

English:

"Debug script.php and find why $user is null at line 42"
"Profile api.php and find the performance bottleneck"
"Trace the authentication flow in login.php"
"Check test coverage for UserService"

日本語:

"script.phpをデバッグして、42行目で$userがnullになる原因を調べて"
"api.phpのパフォーマンスボトルネックを見つけて"
"login.phpの認証フローをトレースして"
"UserServiceのテストカバレッジを確認して"

When connected through the plugin, Skill, or an MCP-capable client, the AI can select the appropriate tool, execute it, and analyze the results.

Requirements

• PHP 8.2+
• Xdebug 3.x extension (installed, but not enabled by default)
• Optional: an AI assistant (Claude Code plugin, Codex Skill, or any MCP-capable client)

💡 Performance Tip: Keep Xdebug disabled in php.ini for daily use. This tool loads Xdebug on-demand only when needed.

Quick Start

1. Install

composer global require koriym/xdebug-mcp

2. Verify Xdebug

"$(composer global config bin-dir --absolute --quiet)/check-env"

3. (Optional) Wire up an AI assistant

Two integrations are available. We recommend the Skill: these tools are stateless one-shot CLI commands by design, so letting the agent run them directly — guided by the Skill’s usage notes — is the simplest and most accurate path. Choose MCP when your client has no shell access or no Skill support.

Claude Code — install the plugin (which bundles the Skill):

/plugin marketplace add koriym/xdebug-mcp
/plugin install xdebug@xdebug-mcp

Codex CLI — install the Skill:

git clone --depth 1 https://github.com/koriym/xdebug-mcp.git /tmp/xdebug-mcp
mkdir -p ~/.codex/skills
cp -r /tmp/xdebug-mcp/skills/xdebug ~/.codex/skills/

Any MCP-capable client — see MCP Configuration below.