# 🚀 Maven Project Generator MCP
Un serveur MCP (Model Context Protocol) pour générer automatiquement des projets Maven complets avec export ZIP intégré,
spécialement conçu pour Claude Desktop.
## 📋 Table des matières
- [🎯 Fonctionnalités](#-fonctionnalités)
- [🔧 Installation](#-installation)
- [⚙️ Configuration](#️-configuration)
- [🎮 Utilisation](#-utilisation)
## 🎯 Fonctionnalités
### ✨ Génération automatique
- **Projets Maven complets** : Applications, plugins, bibliothèques
- **Structure standard** : Respect des conventions Maven
- **Templates intelligents** : Génération de pom.xml optimisés
- **Classes par défaut** : Main.java ou Mojo selon le type
### 🔍 Détection intelligente
- **Auto-détection des packages** Java depuis le code source
- **Extraction automatique** des noms de classes
- **Validation** des structures Maven
- **Gestion d'erreurs** robuste
### 📦 Export et organisation
- **Export ZIP automatique** avec structure complète
- **Gestion des répertoires** automatique
- **Support multi-fichiers** (Java, ressources, documentation)
- **Chemins personnalisés** pour fichiers spéciaux
### 🎨 Types de projets supportés
- **Applications** : Projets Java standard avec main()
- **Plugins Maven** : Avec classes Mojo et annotations
- **Bibliothèques** : Projets jar réutilisables
## 🔧 Installation
### Prérequis
- **Node.js** 18+
- **npm** ou **yarn**
- **Claude Desktop** installé
### 1. Cloner et installer
```bash
git clone <votre-repo>
cd maven-project-generator-mcp
npm install
```
### 2. Compiler le TypeScript
```bash
npm run build
```
## ⚙️ Configuration
### Configuration Claude Desktop
**Fichier de configuration :**
- **Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS/Linux** : `~/.config/claude-desktop/claude_desktop_config.json`
**Contenu :**
```json
{
"mcpServers": {
"maven-project-generator": {
"command": "node",
"args": [
"C:\\chemin\\vers\\votre\\projet\\dist\\index.js"
],
"description": "Générateur de projets Maven avec export ZIP",
"env": {
"NODE_ENV": "production"
}
}
}
}
```
### Variables d'environnement
```bash
# Optionnel : répertoire de sortie par défaut
MAVEN_OUTPUT_DIR=./output
# Optionnel : niveau de log
LOG_LEVEL=info
```
## 🎮 Utilisation
### Commandes disponibles dans Claude Desktop
#### 1. 🏗️ Créer un projet
```
Crée un nouveau projet Maven avec :
- Group ID: com.monentreprise
- Artifact ID: mon-super-plugin
- Type: plugin
- Description: Plugin Maven pour automatiser les builds
```
#### 2. ☕ Ajouter des fichiers Java
```
Ajoute cette classe Java au projet :
package com.monentreprise.utils;
public class StringHelper {
public static String capitalize(String input) {
return input.substring(0, 1).toUpperCase() + input.substring(1);
}
}
```
#### 3. 📄 Ajouter des ressources
```
Ajoute un fichier application.properties avec :
app.name=Mon Application
app.version=1.0.0
```
#### 4. 📦 Générer le ZIP final
```
Génère maintenant le projet Maven complet en ZIP
```
### Workflow typique
1. **Créer** le projet de base
2. **Ajouter** les classes Java nécessaires
3. **Configurer** les ressources
4. **Personnaliser** le pom.xml si besoin
5. **Générer** le ZIP final
## 🔍 API Documentation
### Interface `MavenProject`
```typescript
interface MavenProject {
groupId: string; // Identifiant du groupe
artifactId: string; // Identifiant de l'artifact
version: string; // Version du projet
name?: string; // Nom affiché
description?: string; // Description
javaVersion?: string
