Aller au contenu principal

MCP Server

Ouvrir dans ChatGPT

Le serveur du Protocole de Contexte de Modèle webforJ (MCP) fournit aux assistants AI un accès direct à la documentation officielle de webforJ, des exemples de code vérifiés et des modèles spécifiques au cadre, permettant des réponses avec des réponses plus précises et une génération de projet automatisée spécifiquement pour le développement webforJ.

Qu'est-ce qu'un MCP ?​

Le Protocole de Contexte de Modèle est une norme ouverte qui permet aux assistants AI de se connecter à des outils et des documentations externes. Le serveur MCP webforJ met en œuvre ce protocole pour fournir :

  • Recherche de connaissances - Recherche en langage naturel dans la documentation webforJ, les exemples de code et les modèles
  • Génération de projet - Créer des applications webforJ à partir de modèles officiels avec une structure appropriée
  • Création de thème - Générer des thèmes CSS accessibles en suivant les modèles de conception webforJ

Pourquoi utiliser MCP ?​

Alors que les assistants AI en matière de codage excellent à répondre à des questions basiques, ils ont du mal avec des requêtes spécifiques à webforJ qui couvrent plusieurs sections de documentation. Sans accès direct à des sources officielles, ils peuvent :

  • Générer des méthodes qui n'existent pas dans webforJ
  • Référencer des modèles d'API obsolètes ou incorrects
  • Fournir du code qui ne compilera pas
  • Confondre la syntaxe webforJ avec d'autres frameworks Java
  • Mal comprendre les modèles spécifiques à webforJ

Avec l'intégration MCP, les réponses AI sont ancrées dans la documentation officielle webforJ, des exemples de code et des modèles de cadre, fournissant des réponses vérifiables avec des liens directs vers des sources officielles pour une exploration plus approfondie.

L'IA peut encore faire des erreurs

Bien que le MCP améliore considérablement l’exactitude en fournissant un accès aux ressources officielles de webforJ, il ne garantit pas une génération de code parfaite. Les assistants AI peuvent encore faire des erreurs dans des scénarios complexes. Vérifiez toujours le code généré et testez-le de manière approfondie avant de l'utiliser en production.

Installation​

Le serveur MCP webforJ est hébergé à https://mcp.webforj.com avec deux points de terminaison :

  • Point de terminaison MCP (/mcp) - Pour Claude, VS Code, Cursor
  • Point de terminaison SSE (/sse) - Pour les clients hérités

Utilisez la commande CLI Claude pour enregistrer le serveur :

claude mcp add webforj-mcp https://mcp.webforj.com/mcp -t http -s user

Cela configurera automatiquement le serveur MCP dans votre environnement Claude Code.

Outils disponibles​

Les outils sont des fonctions spécialisées que le serveur MCP fournit aux assistants AI. Lorsque vous posez une question ou faites une demande, l'IA peut appeler ces outils pour rechercher de la documentation, générer des projets ou créer des thèmes. Chaque outil accepte des paramètres spécifiques et renvoie des données structurées qui aident l'IA à fournir une assistance précise et contextuelle.

Cet outil fournit des capacités de recherche sémantique à travers tout l'écosystème de documentation webforJ. Il comprend le contexte et les relations entre les différents concepts du cadre, renvoyant des sections de documentation pertinentes, des références d'API et des exemples de code fonctionnels.

Exemples de requêtes :

"Rechercher dans la documentation webforJ des exemples de composant Button avec des icônes"

"Trouver des modèles de validation de formulaire webforJ dans la documentation la plus récente"

"Montrez-moi la configuration actuelle du routage webforJ avec l'annotation @Route"

"Rechercher dans la documentation webforJ des modèles de design responsive FlexLayout"

"Trouver l'intégration de composants webforj dans la documentation officielle"

Génère des applications webforJ complètes en utilisant des archétypes Maven officiels. L'outil crée une structure de répertoire de projet standardisée et inclut un code de démarrage basé sur le modèle sélectionné. Les projets générés comprennent un système de construction prêt à l'emploi, des dossiers de ressources et des fichiers de configuration pour un développement et un déploiement immédiats.

Exemples de requêtes :

"Créer un projet webforJ nommé CustomerPortal en utilisant l'archétype hello-world"

"Générer un projet webforJ Spring Boot avec un agencement d'onglets nommé Dashboard"

"Créer une nouvelle application webforJ avec l'archétype sidemenu pour le projet AdminPanel"

"Générer un projet webforJ vierge nommé TestApp avec le groupId com.example"

"Créer le projet webforJ InventorySystem en utilisant l'archétype sidemenu avec Spring Boot"

Lorsque vous utilisez cet outil, vous pouvez choisir parmi plusieurs modèles de projet :

Archétypes (modèles de projet) :

  • hello-world - Application de base avec des composants d'exemple pour démontrer les fonctionnalités de webforJ
  • blank - Structure de projet minimale pour commencer de zéro
  • tabs - Mise en page d'interface à onglets préconstruite pour les applications à multi-vues
  • sidemenu - Mise en page de menu de navigation latérale pour les panneaux d'administration ou les tableaux de bord

Saveurs (intégration de cadre) :

  • webforj - Application webforJ standard
  • webforj-spring - webforJ intégré avec Spring Boot pour l'injection de dépendances et des fonctionnalités d'entreprise
Archétypes disponibles

webforJ vient avec plusieurs archétypes prédéfinis pour vous aider à commencer rapidement. Pour une liste complète des archétypes disponibles, consultez le catalogue d'archétypes.

Génère des configurations de thème webforJ en utilisant DWC HueCraft. L'outil crée des ensembles de propriétés CSS personnalisées complètes avec des variantes de couleurs primaires, secondaires, de succès, d'avertissement, de danger et neutres.

Exemples de requêtes :

"Générer un thème webforJ avec HSL 220, 70, 50 comme couleur primaire pour notre marque"

"Créer un thème webforJ accessible nommé 'océan' avec la couleur primaire #0066CC"

"Générer un thème webforJ en utilisant notre couleur de marque #FF5733"

"Créer un thème webforJ avec HSL 30, 100, 50 nommé 'coucher de soleil' pour notre application"

"Générer un thème webforJ accessible avec la couleur primaire RGB 44, 123, 229"

Prompts disponibles​

Les prompts sont des instructions AI préconfigurées qui combinent plusieurs outils et workflows pour des tâches courantes. Ils guident l'IA à travers des étapes et des paramètres spécifiques pour fournir des résultats fiables et répétables pour chaque flux de travail pris en charge.

Arguments :

  • appName (obligatoire) - Nom de l'application (par exemple, MyApp, TodoList, Dashboard)
  • archetype (obligatoire) - Choisir parmi : blank, hello-world, tabs, sidemenu
  • runServer (optionnel) - Exécuter automatiquement le serveur de développement (oui/non)

Arguments :

  • primaryColor (obligatoire) - Couleur en format hex (#FF5733), rgb (255,87,51) ou hsl (9,100,60)

Le prompt configure l'IA pour :

  1. Rechercher dans la base de connaissances de manière extensive
  2. Écrire un code complet, prêt pour la production
  3. Compiler le projet en utilisant mvn compile pour vérifier qu'il n'y a pas d'erreurs de compilation
  4. Corriger les erreurs de manière itérative jusqu'à ce que tout fonctionne

Comment utiliser les prompts​

  1. Tapez / dans le chat pour voir les prompts disponibles
  2. Sélectionnez un prompt dans le menu déroulant
  3. Remplissez les paramètres requis lorsqu'on vous le demande

Meilleures pratiques​

Pour obtenir l'assistance webforJ la plus précise et à jour, suivez ces directives pour tirer pleinement parti des fonctionnalités du serveur MCP.

Assurer l'utilisation du serveur MCP​

Les modèles AI peuvent ignorer le serveur MCP s'ils pensent déjà connaître la réponse. Pour garantir que le serveur MCP est réellement utilisé :

  • Soyez explicite sur webforJ : Mentionnez toujours "webforJ" dans votre requête pour déclencher des recherches spécifiques au cadre
  • Demander des informations à jour : Incluez des phrases comme "documentation webforJ la plus récente" ou "modèles webforJ actuels"
  • Demander des exemples vérifiés : Demandez "exemples de code webforJ fonctionnels" pour forcer la recherche de documentation
  • Faire référence à des versions spécifiques : Mentionnez votre version de webforJ (par exemple, "webforJ 25.02") pour obtenir des résultats précis

Rédaction de prompts spécifiques​

Bons exemples :

"Rechercher dans la documentation webforJ le traitement des événements du composant Button avec des exemples"

"Créer un projet webforJ nommé InventorySystem en utilisant l'archétype sidemenu avec Spring Boot"

"Générer un thème webforJ avec HSL 220, 70, 50 comme couleur primaire pour la marque"

Mauvais exemples :

"Comment fonctionnent les boutons"

"Créer une application"

"Fais-le bleu"

Forcer l'utilisation de l'outil MCP​

Si l'IA fournit des réponses génériques sans utiliser le serveur MCP :

  1. Demander explicitement : "Utilisez le serveur MCP webforJ pour rechercher [requête]"
  2. Demander des références de documentation : "Trouvez dans la documentation webforJ comment [requête]"
  3. Demander une vérification : "Vérifiez cette solution par rapport à la documentation webforJ"
  4. Soyez spécifique au cadre : Incluez toujours "webforJ" dans vos requêtes

Personnalisation de l'IA​

Configurez vos assistants AI pour utiliser automatiquement le serveur MCP et suivre les meilleures pratiques webforJ. Ajoutez des instructions spécifiques au projet afin que vos assistants AI utilisent toujours le serveur MCP, respectent les normes de documentation webforJ et fournissent des réponses précises et à jour répondant aux exigences de votre équipe.

Fichiers de configuration de projet​

  • Pour VS Code et Copilot, créez .github/copilot-instructions.md
  • Pour Claude Code, créez CLAUDE.md à la racine de votre projet

Ajoutez ce qui suit au fichier markdown créé :

## Utilisez le serveur MCP webforJ pour répondre à toutes les questions webforJ

- Appelez toujours l'outil "webforj-knowledge-base" pour récupérer les documents pertinents à la question
- Vérifiez toutes les signatures d'API par rapport à la documentation officielle
- Ne supposez jamais que les noms de méthodes ou les paramètres existent sans vérification

Vérifiez toujours que le code compile avec `mvn compile` avant de le suggérer.

FAQ​

La plupart des assistants AI nécessitent des instructions explicites pour utiliser les serveurs MCP. Configurez votre client AI avec les instructions de la section Personnalisation de l'IA. Sans ces instructions, les assistants AI peuvent utiliser par défaut leurs données d'apprentissage au lieu d'interroger le serveur MCP.

Solution rapide : Incluez "utilisez le MCP webforJ" dans votre prompt ou créez le fichier de configuration approprié (.github/copilot-instructions.md ou CLAUDE.md).

Utilisez l'inspecteur MCP pour déboguer les connexions :

npx @modelcontextprotocol/inspector

Attendez le message : 🔍 L'inspecteur MCP est en cours d'exécution à http://127.0.0.1:6274 (le port peut varier)

Ensuite, dans l'inspecteur :

  1. Entrez l'URL du serveur MCP : https://mcp.webforj.com/mcp
  2. Cliquez sur "Connecter" pour établir la connexion
  3. Visualisez les outils disponibles et testez les requêtes
  4. Surveillez les journaux requête/réponse pour le débogage

Le serveur MCP webforJ fournit deux points de terminaison :

  • Point de terminaison MCP (/mcp) - Protocole moderne pour Claude, VS Code, Cursor
  • Point de terminaison SSE (/sse) - Événements envoyés par le serveur pour les clients hérités comme Windsurf

La plupart des utilisateurs devraient utiliser le point de terminaison MCP. N'utilisez SSE que si votre client ne prend pas en charge le protocole MCP standard.

Oui, mais ce n'est pas recommandé. Sans fichiers de configuration, vous devez manuellement inciter l'IA à utiliser le serveur MCP dans chaque conversation. Les fichiers de configuration instruisent automatiquement l'IA d'utiliser le serveur MCP pour chaque interaction, afin que vous n'ayez pas à répéter les instructions à chaque fois.

Approche manuelle : Commencez les prompts par : "Utilisez le serveur MCP webforJ pour..."

Alternative : Utilisez des prompts préconfigurés Le serveur MCP fournit des prompts qui fonctionnent sans fichiers de configuration :

  • /create-app - Générer de nouvelles applications webforJ
  • /create-theme - Créer des thèmes CSS accessibles
  • /search-webforj - Recherche de documentation avancée

Consultez Prompts disponibles pour les détails.

Signaler des problèmes : Retour d'information sur le MCP webforJ

Problèmes courants à signaler :

  • Documentation obsolète dans les résultats de recherche
  • Méthodes ou composants d'API manquants
  • Exemples de code incorrects
  • Erreurs d'exécution d'outil

Incluez votre requête, le résultat attendu et le résultat réel lors de la signalisation de problèmes.