xdebug-mcp

Serveur MCP pour analyser des fichiers de profiling Xdebug (format cachegrind).

Prérequis

• Un fichier de profiling Xdebug (.gz ou texte brut) généré avec xdebug.mode=profile
• Optionnel : make + Go (pour la compilation locale)

Sommaire

• Prérequis
• À quoi sert ce serveur MCP ?
• Installation
• Utilisation avec un client MCP
• Documentation

À quoi sert ce serveur MCP ?

xdebug-mcp permet à un client MCP d'analyser des fichiers de profiling Xdebug sans outil externe :

• analyse globale d'un profil : stats générales et top N fonctions par coût inclusif ;
• liste des appelants d'une fonction donnée, triés par coût décroissant ;
• liste des appelés d'une fonction donnée, triés par coût décroissant.

Installation

Option principale : script d'installation

Installer la dernière release publique et lancer l'assistant de configuration :

curl -fsSL https://get.lclr.dev/mcp/xdebug/install.sh | bash

Option alternative : binaire de la dernière release

Télécharger le binaire adapté à votre OS depuis la page des releases publiques :

https://forge.lclr.dev/AI/xdebug-mcp/releases

Puis le rendre exécutable (Linux/macOS) :

chmod +x /absolute/path/to/xdebug-mcp

Option alternative : compilation locale

make build

Binaire généré : build/xdebug-mcp (ou build/xdebug-mcp-linux-amd64 selon la cible).

Utilisation avec un client MCP

Claude Code CLI

claude mcp add xdebug-mcp -- /absolute/path/to/xdebug-mcp mcp

Configuration JSON

{
  "mcpServers": {
    "xdebug-mcp": {
      "command": "/absolute/path/to/xdebug-mcp",
      "args": ["mcp"]
    }
  }
}

Documentation

• Référence des outils MCP