mat-drupal-mcp/QUICKSTART.md

MatDrupal MCP - AI Assistant for Drupal Projects with bilingual FR/EN support

# 🚀 Guide de Démarrage Rapide - MatDrupal MCP Server

## Installation et Test

```bash
# 1. Installer les dépendances
npm install

# 2. Compiler le projet
npm run build

# 3. Tester le serveur
npm test

# 4. Exécuter la suite de tests complète
./test-mcp.sh
```

## Configuration GitHub Copilot

### Option 1: Configuration automatique (recommandée)
```bash
# Exécuter le script de setup automatique
./setup.sh
```

### Option 2: Configuration manuelle

1. **Copier le fichier de configuration:**
```bash
cp .vscode/mcp.json ~/.config/Code/User/globalStorage/github.copilot-chat/mcp.json
```

2. **Ou éditer directement le fichier de configuration GitHub Copilot:**
```json
{
  "servers": {
    "matdrupal": {
      "type": "stdio", 
      "command": "node",
      "args": ["/chemin/vers/mat-drupal-mcp/dist/index.js"],
      "env": {
        "LANDO_SUPPORT": "true",
        "ACQUIA_CLI_SUPPORT": "true",
        "MATDRUPAL_MODE": "true", 
        "BILINGUAL_MODE": "true"
      }
    }
  }
}
```

## Utilisation avec GitHub Copilot

Une fois configuré, vous pouvez utiliser ces commandes dans GitHub Copilot Chat:

### 🔍 Analyse de Projet
```
@matdrupal Analyse complète du projet Drupal dans ce répertoire
```

### 📦 Analyse de Module
```
@matdrupal Explore le module custom "mon_module"
```

### 🔧 Évaluation Technique
```
@matdrupal Évalue la dette technique et génère un roadmap D11
```

### 🐳 Gestion Lando
```
@matdrupal Analyse l'environnement Lando
```

### ☁️ Support Acquia
```
@matdrupal Vérifie la compatibilité Acquia CLI
```

## Outils Disponibles

| Outil | Description | Usage |
|-------|-------------|-------|
| `analyze_project_overview` | Analyse complète du projet | Détection docroot, version Drupal, modules |
| `explore_custom_module` | Analyse détaillée d'un module | Dependencies, info.yml, structure |
| `assess_technical_debt` | Évaluation dette technique | Roadmap D11, complexité migration |
| `manage_lando_environment` | Gestion Lando | start/stop/analyze |
| `acquia_intelligence_helper` | Support Acquia CLI | Compatibilité, versions |

## Variables d'Environnement

```bash
# Support des outils optionnels
export LANDO_SUPPORT=true          # Active les fonctions Lando
export ACQUIA_CLI_SUPPORT=true     # Active les fonctions Acquia CLI
export MATDRUPAL_MODE=true         # Active le mode MatDrupal spécialisé
export BILINGUAL_MODE=true         # Active le support français/anglais
```

## Débogage

```bash
# Voir les logs du serveur
node dist/index.js --test

# Vérifier la version
node dist/index.js --version

# Tester avec options
LANDO_SUPPORT=true node dist/index.js --test
```

## Structure du Projet

```
mat-drupal-mcp/
├── src/index.ts              # Code source principal
├── dist/index.js             # Version compilée
├── package.json              # Dependencies et scripts
├── tsconfig.json             # Configuration TypeScript
├── setup.sh                  # Script d'installation automatique
├── test-mcp.sh              # Suite de tests
├── .vscode/mcp.json         # Configuration VS Code
└── README.md                # Documentation complète
```

## Prochaines Étapes

1. ✅ Installation et compilation
2. ✅ Configuration GitHub Copilot  
3. 🔄 Test sur un projet Drupal réel
4. 📈 Utilisation des outils d'analyse
5. 🎯 Optimisation et personnalisation

---

*Pour plus de détails, consultez le [README.md](README.md) complet.*