🚀 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
✨ 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
- Créer le projet de base
- Ajouter les classes Java nécessaires
- Configurer les ressources
- Personnaliser le pom.xml si besoin
- 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