mat-drupal-mcp/docs/npm-publication.md

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

# 📦 Guide de Publication NPM - MatDrupal MCP

Ce guide explique comment publier MatDrupal MCP en tant que package npm global.

## 🎯 Pourquoi NPM + Installation curl ?

### 📦 Package NPM (pour développeurs)
- Installation simple et standardisée
- Gestion des versions automatique
- Intégration dans pipelines CI/CD
- Désinstallation propre

### 🌐 Installation curl (pour utilisateurs finaux)
- Configuration automatique complète
- Pas besoin de connaissances npm
- Configuration GitHub Copilot incluse
- Support pour utilisateurs non-techniques

## 🚀 Publication NPM

### 1. Préparation

```bash
# Se connecter à npm (une seule fois)
npm login

# Vérifier la connexion
npm whoami
```

### 2. Publication automatique

```bash
# Script automatique (recommandé)
./scripts/publish-npm.sh

# Ou publication manuelle
npm run build
npm test
npm publish
```

### 3. Vérification

```bash
# Voir le package publié
npm view mat-drupal-mcp

# Tester l'installation globale
npm install -g mat-drupal-mcp
matdrupal --version
```

## 📋 Instructions d'installation pour utilisateurs

### Installation NPM (développeurs)

```bash
# Installation globale
npm install -g mat-drupal-mcp

# Utilisation
matdrupal --test
```

⚠️ **Note**: L'installation npm installe seulement le binaire. La configuration GitHub Copilot doit être faite manuellement.

### Installation complète (utilisateurs finaux)

```bash
# Installation + configuration automatique (recommandé)
curl -sL https://raw.githubusercontent.com/boisvertmath/mat-drupal-mcp/main/scripts/install.sh | bash
```

Cette méthode inclut :
- Installation du package
- Configuration GitHub Copilot automatique
- Scripts de mise à jour
- Configuration optimale

## 🔄 Mise à jour des deux approches

### Documentation README

Mettre à jour le README avec les deux options :

```markdown
## 🚀 Installation

### Option 1: Installation complète (recommandée)
```bash
curl -sL https://raw.githubusercontent.com/boisvertmath/mat-drupal-mcp/main/scripts/install.sh | bash
```

### Option 2: Package NPM (développeurs)
```bash
npm install -g mat-drupal-mcp
# Configuration GitHub Copilot manuelle requise
```

## 📦 Gestion des versions

### NPM
- Utilise la version du `package.json`
- `npm update -g mat-drupal-mcp`

### Installation curl
- Télécharge toujours la dernière version GitHub
- Script de mise à jour inclus: `~/.matdrupal/update.sh`

## 🎯 Recommandations par audience

### Développeurs/DevOps
```bash
npm install -g mat-drupal-mcp
```

### Utilisateurs finaux/Équipes
```bash
curl -sL https://raw.githubusercontent.com/boisvertmath/mat-drupal-mcp/main/scripts/install.sh | bash
```

### Environnements Docker/CI
```dockerfile
RUN npm install -g mat-drupal-mcp
```

---

*Les deux approches restent maintenues pour servir différents besoins d'utilisateurs.*