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/xstep.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/xtrace.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/xprofile.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

xstep

Interactive debugging with conditional breakpoints and step recording

xtrace

Complete execution tracing with comprehensive statistics

xprofile

Performance profiling with bottleneck detection

xcoverage

Code coverage analysis with multiple report formats

xback

Stack trace at specific breakpoints for debugging flow

xdebug-mcp

MCP server for AI integration and programmatic access