Download the PHP package koriym/xdebug-mcp without Composer
On this page you can find all versions of the php package koriym/xdebug-mcp. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package xdebug-mcp
PHP Xdebug MCP Server
Error message is the crime photo. Trace is the crime footage.
Don't just see the crime. Watch how it happened.
Enable AI to Debug PHP Autonomously, Beyond Human IDE Capabilities
-NO-red)
The Problem: From var_dump() to xdebug_start_trace()
When you ask AI to debug PHP today, it adds var_dump()
to your code—the same technique from 30 years ago.
Why? Because AI is debugging blind, only able to read static code and guess what happens at runtime.
The Solution: Forward Trace™
Transform AI debugging from var_dump()
to xdebug_start_trace()
— a paradigm shift from static guesswork to runtime intelligence.
This MCP server enables AI to debug PHP with superhuman capabilities:
- Watch execution unfold live: Record runtime behavior from any point forward as it happens
- Track variable evolution: Watch every variable change step-by-step
- Set intelligent traps: Conditional breakpoints that capture exact problem moments
- Verify AI code quality: Beyond tests passing - see if code is actually efficient
- Share debug sessions: Schema-validated JSON that any AI can analyze
- Debug without touching code: Zero var_dumps, zero pollution
Quick Start
Forward Trace™ vs Traditional Debugging
Traditional Debugging | Forward Trace |
---|---|
Post-crash investigation | Live execution monitoring |
Add var_dump(), test, remove | Zero code modification |
Manual stepping through IDE | Automatic variable evolution recording |
One developer, one session | Schema-validated JSON for any AI |
Hours of investigation | Seconds of AI analysis |
Two Powerful Modes
1. Conditional Breakpoints - Stop when problems occur:
2. Step Recording - Watch variable evolution:
Common Usage Patterns
Catch Null Values (The #1 PHP Bug):
Performance Analysis:
Variable Evolution:
AI Code Quality Verification:
Vendor Filtering (Focus on specific packages):
AI Slash Commands (Claude Code):
Available Tools
🤖 AI-Optimized CLI Tools
All tools now feature comprehensive AI-optimized help documentation. Always run --help
first to understand optimal usage patterns:
-
xdebug-debug
🔍 - Interactive debugging shell with conditional breakpoints and step recording -
xdebug-coverage
🎯 - Superior alternative to PHPUnit HTML/XML coverage for AI analysis -
xdebug-trace
📊 - Ultimate alternative to static code analysis -
xdebug-profile
⚡ - Scientific performance optimization with precision metrics xdebug-phpunit
- PHPUnit integration with Xdebug profiling and coverage
🎯 AI-First Design Philosophy
Start Here: Every tool includes comprehensive AI-optimized help documentation designed to teach optimal usage patterns:
What makes this AI-optimized?
- ✅ Value Proposition Clear: Why this beats traditional debugging methods
- ✅ Workflow Integration: Step-by-step AI collaboration processes
- ✅ Practical Examples: Real-world usage patterns with context
- ✅ Output Optimization: JSON formats designed for AI consumption
- ✅ Cognitive Load Reduction: Mixed output streams AI can parse efficiently
AI Integration Features
- 42+ MCP Tools: Performance profiling, code coverage, execution tracing, memory diagnostics, error tracking
- Slash Commands:
/x-debug
,/x-profile
,/x-trace
,/x-coverage
for Claude Code - Schema-Validated Output: JSON that any AI can understand and analyze
- Dynamic Vendor Filtering: AI can specify which vendor packages to include/exclude during analysis
Installation
Troubleshooting & Diagnostics
Resources
📋 TROUBLESHOOTING.md - Setup and common issues
🎯 Forward Trace Guide - AI debugging methodology
📖 MOTIVATION.md - Why we built this
🎬 Interactive Presentation - See the paradigm shift
📚 Xdebug Documentation - Official Xdebug docs
Stop debugging blind. Give AI the power of Forward Trace.
Transform your PHP debugging from guesswork to intelligence.
Debug once, analyze anywhere - with schema-validated JSON that any AI can understand.
All versions of xdebug-mcp with dependencies
ext-sockets Version *
ext-xml Version *
symfony/polyfill-php83 Version ^1.33
amphp/socket Version ^2.3