项目简介

xdebug-mcp 是一个基于 Model Context Protocol (MCP) 的服务器实现，专门用于PHP代码的调试和分析。它允许AI助手通过自然语言指令来执行断点调试、性能分析、代码覆盖率检查等操作。

主要功能点

• 断点调试：在指定行设置断点，检查变量状态
• 执行追踪：分析代码执行流程和调用栈
• 性能分析：识别代码中的性能瓶颈
• 代码覆盖率：分析测试用例覆盖的代码行
• 堆栈分析：在特定断点显示完整的调用堆栈
• 交互式调试：提供REPL界面进行手动调试
• 容器支持：兼容 Docker、Podman 和 Kubectl 环境
• 智能过滤：自动过滤vendor依赖，专注于应用代码

安装步骤

1. 环境要求

• PHP 8.1+
• Xdebug 3.x 扩展（已安装但默认不启用）

2. 安装MCP服务器

composer global require koriym/xdebug-mcp

3. 验证Xdebug配置

~/.composer/vendor/bin/check-env

3. MCP服务器配置

在项目根目录创建 '.mcp.json' 配置文件：

{
  "mcpServers": {
    "xdebug": {
      "command": "php",
      "args": ["/Users/YOUR_USERNAME/.composer/vendor/bin/xdebug-mcp"

配置说明：

• 'server name'：xdebug（在mcpServers对象中的键名）
• 'command'：php（PHP解释器）
• 'args'：xdebug-mcp可执行文件的完整路径）

4. 基本使用方法

安装配置后，重启AI助手即可使用自然语言进行PHP调试：

示例指令：

• "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"

注意事项

• 性能优化：建议在php.ini中禁用Xdebug，该工具仅在需要时按需加载Xdebug，避免性能影响。

技能模式（推荐）

作为MCP的替代方案，项目还提供预配置的Claude技能，更简单易用：

ln -s ~/.composer/vendor/koriym/xdebug-mcp/skills/xdebug ~/.claude/skills/xdebug

此模式自动提供所有调试工具，无需复杂配置。