🚀 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
• 🔧 Installation
• ⚙️ Configuration
• 🎮 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

git clone <votre-repo>
cd maven-project-generator-mcp
npm install

2. Compiler le TypeScript

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 :

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

# 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

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