Xdebug MCP Server

JSON Schema definitions and comprehensive documentation for Xdebug MCP Server - Forward Trace™ debugging and runtime analysis designed for AI-powered debugging.

Debug Schema

Main schema for conditional debugging with breakpoints and step recording

Forward Trace™: Captures execution from start until problems occur, eliminating need for var_dump() and code modifications.

schemas/xdebug-debug.json

Trace Schema

Schema for Xdebug execution traces (.xt format) with comprehensive statistics

AI-optimized: Includes total_lines, unique_functions, max_call_depth, and database_queries for intelligent analysis strategies.

schemas/xdebug-trace.json

Profile Schema

Schema for performance profiling data (Cachegrind format) with optimization insights

Performance analysis: Bottleneck detection, execution timing, memory usage, and AI-generated optimization suggestions.

schemas/xdebug-profile.json

Documentation & Guides

🤖 AI Debugging Guidelines

Forward Trace™ methodology for AI assistants: conditional breakpoints, step recording, and runtime analysis without code modifications

AI-Optimized: Automatic tool usage, schema-validated output, and non-invasive debugging principles for AI assistants. Cross-references with human developer guide.

debug_guideline_for_ai.md

👨‍💻 Human Developer Guidelines

Practical Forward Trace workflows for human developers: daily debugging patterns, team collaboration, and IDE integration

Developer-Focused: IDE integration, troubleshooting, team workflows, and migration from traditional debugging methods. Cross-references with AI assistant guide.

debug_guideline_for_humans

Forward Trace Revolution Presentation

Interactive presentation showcasing the paradigm shift from var_dump() debugging to AI-powered Forward Trace methodology

Interactive Demo: Visual explanation of Forward Trace concepts, conditional breakpoints, and AI collaboration benefits.

slide/

Troubleshooting Guide

Comprehensive solutions for common issues: environment setup, Forward Trace problems, MCP protocol issues, and performance optimization

Complete Reference: Quick diagnostics, error codes, reset procedures, and issue reporting templates.

TROUBLESHOOTING

Claude Code Instructions

Comprehensive instructions for Claude Code CLI integration, MCP protocol usage, and AI debugging workflows

AI Integration: Forward Trace principles, task management, code style guidelines, and non-invasive debugging methodology.

CLAUDE.md

Complete AI Documentation

Extended documentation with complete CLAUDE.md integration instructions and comprehensive MCP tool reference

Full Context: Complete project documentation including installation, usage examples, and AI assistant setup instructions.

llms-full.txt

Project README

Main project documentation with installation, usage, and MCP server setup instructions

Getting Started: Installation guide, MCP configuration, CLI tools usage, and integration examples.

README.md

CLI Tools

xdebug-debug

Interactive debugging with conditional breakpoints and step recording

xdebug-trace

Complete execution tracing with comprehensive statistics

xdebug-profile

Performance profiling with bottleneck detection

xdebug-coverage

Code coverage analysis with multiple report formats

xdebug-phpunit

PHPUnit integration with Xdebug profiling and coverage

xdebug-mcp

MCP server for AI integration and programmatic access