
koriym/xdebug-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
AI が Xdebug で PHP をデバッグできるようにする
概要
Xdebug 上に構築された PHP 用の Trace ベースのデバッグ。 CLI からツールをドライブしたり、AI アシスタントがプラグイン、スキル、または MCP 統合を通じてコア ツールを実行できるようにします。 必要なAIアシスタントを教えてください。 プラグイン、スキル、またはMCP対応のクライアントを介して接続すると、AIは適切なツールを選択して実行し、結果を分析することができます。 - PHP 8.2 + - Xdebug 3.x 拡張 (インストール、デフォルトで有効) - オプション: AI アシスタント (Claude コード プラグイン、Codex スキル、または MCP 対応クライアント) php.ini で Xdebug を無効にして毎日使用してください。 このツールは、必要に応じてXdebugオンデマンドをロードします。 2つの統合が利用できます。 : これらのツールは、デザインによってステートレスな1ショットのCLIコマンドです。そのため、エージェントが直接実行できるようにします。これは、スキルの使い方のメモによってガイドされます。最も簡単で正確なパスです。 シェルアクセスやスキルサポートがない場合、MCP を選択します.
概要(AI 翻訳)
ランタイムデータでPHPをデバッグ — var dump() なし、 Guesswork なし
Xdebug 上に構築された PHP 用の Trace ベースのデバッグ。 CLI からツールをドライブしたり、AI アシスタントがプラグイン、スキル、または MCP 統合を通じてコア ツールを実行できるようにします。
-NO-赤)
お問い合わせ
自然言語のデバッグ
必要なAIアシスタントを教えてください。
英語:*
日本語:*
プラグイン、スキル、またはMCP対応のクライアントを介して接続すると、AIは適切なツールを選択して実行し、結果を分析することができます。
要件
- PHP 8.2 以降
- Xdebug 3.x 拡張子(インストール済みですが、**デフォルトでは有効ではありません)
- オプション:AIアシスタント(Claudeコードプラグイン、Codexスキル、またはMCP対応クライアント)
パフォーマンスヒント: php.ini で Xdebug を無効にして毎日使用してください。 このツールは、必要に応じてXdebugオンデマンドをロードします。
クイックスタート
##1. インストール
##2. Xdebug の検証
##3.(任意) AIアシスタントをワイヤーアップ
2つの統合が利用可能です。 スキル: これらのツールは、デザインによってステートレスワンショットのCLIコマンドであるので、エージェントが直接実行できるようにします。これは、スキルの使い方のメモによってガイドされるため、最も簡単で正確なパスです.
このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。
README
以下は原文 README の抜粋です。原文を見る。
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.
| Skill (recommended) | MCP server | |
|---|---|---|
| How it works | The agent reads SKILL.md and runs the CLI tools directly |
The client calls the tools over JSON-RPC (stdio) |
| Setup | Plugin install, or copy one directory | Register in the client’s MCP config |
| Best for | AI coding agents with shell access (Claude Code, Codex, …) | MCP-capable clients without shell/Skill support (e.g. Claude Desktop) |
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.
インストール
This server does not publish a one-line install command.
Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →設定
{
"mcpServers": {
"xdebug": {
"command": "php",
"args": ["/ABSOLUTE/PATH/TO/xdebug-mcp"]
}
}
}