@enokdev/springdocs-mcp 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,82 +1,82 @@
 # Changelog - Spring Boot MCP Server
 
-Toutes les modifications notables de ce projet seront documentées dans ce fichier.
+All notable changes to this project will be documented in this file.
 
-Le format est basé sur [Keep a Changelog](https://keepachangelog.com/fr/1.0.0/),
-et ce projet adhère au [versioning sémantique](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [1.1.0] - 2025-08-21
 
-### ✨ Ajouté
-- **Support complet de spring.io/projects** - Accès à tous les projets Spring (Security, Data, Cloud, etc.)
-- **Nouvel outil `search_spring_projects`** - Recherche parmi tous les projets Spring disponibles
-- **Nouvel outil `get_spring_project`** - Récupération des détails complets d'un projet Spring spécifique
-- **Nouvel outil `get_all_spring_guides`** - Liste tous les guides Spring avec filtrage par catégorie
-- **Base de connaissances étendue** - Projets Spring populaires intégrés pour un fallback robuste
-- **Documentation enrichie** - Guides d'exemples pratiques (EXAMPLES.md)
-- **Guide de contribution** - Documentation pour les développeurs (CONTRIBUTING.md)
-
-### 🔧 Amélioré
-- **Couverture documentaire élargie** - Passage de 4 à 7 outils MCP
-- **Robustesse du service** - Mécanismes de fallback pour les projets et guides populaires
-- **Performance des requêtes** - Optimisation du parsing HTML et conversion Markdown
-- **Tests étendus** - Script de test mis à jour avec tous les nouveaux outils
-
-### 📚 Sources de documentation ajoutées
-- `https://spring.io/projects` - Catalogue complet des projets Spring
-- `https://spring.io/guides` - Collection étendue de guides pratiques
-- Base de connaissances des projets populaires (Boot, Security, Data, Cloud, etc.)
-
-### 🛠️ Outils MCP (7 au total)
-1. `search_spring_docs` - Recherche dans la documentation Spring Boot *(existant)*
-2. `search_spring_projects` - **NOUVEAU** - Recherche de projets Spring
-3. `get_spring_project` - **NOUVEAU** - Détails d'un projet Spring
-4. `get_all_spring_guides` - **NOUVEAU** - Liste des guides Spring
-5. `get_spring_guide` - Récupération d'un guide spécifique *(existant)*
-6. `get_spring_reference` - Documentation de référence *(existant)*
-7. `search_spring_concepts` - Recherche de concepts *(existant)*
+### ✨ Added
+- **Complete spring.io/projects support** - Access to all Spring projects (Security, Data, Cloud, etc.)
+- **New `search_spring_projects` tool** - Search among all available Spring projects
+- **New `get_spring_project` tool** - Retrieve complete details of a specific Spring project
+- **New `get_all_spring_guides` tool** - List all Spring guides with category filtering
+- **Extended knowledge base** - Popular Spring projects integrated for robust fallback
+- **Enhanced documentation** - Practical examples guide (EXAMPLES.md)
+- **Contribution guide** - Developer documentation (CONTRIBUTING.md)
+
+### 🔧 Improved
+- **Expanded documentation coverage** - From 4 to 7 MCP tools
+- **Service robustness** - Fallback mechanisms for popular projects and guides
+- **Query performance** - Optimized HTML parsing and Markdown conversion
+- **Extended testing** - Updated test script with all new tools
+
+### 📚 Added Documentation Sources
+- `https://spring.io/projects` - Complete catalog of Spring projects
+- `https://spring.io/guides` - Extended collection of practical guides
+- Popular projects knowledge base (Boot, Security, Data, Cloud, etc.)
+
+### 🛠️ MCP Tools (7 total)
+1. `search_spring_docs` - Search Spring Boot documentation *(existing)*
+2. `search_spring_projects` - **NEW** - Search Spring projects
+3. `get_spring_project` - **NEW** - Spring project details
+4. `get_all_spring_guides` - **NEW** - List Spring guides
+5. `get_spring_guide` - Retrieve specific guide *(existing)*
+6. `get_spring_reference` - Reference documentation *(existing)*
+7. `search_spring_concepts` - Search concepts *(existing)*
 
 ## [1.0.0] - 2025-08-21
 
-### ✨ Version initiale
-- **Serveur MCP fonctionnel** - Implémentation complète du protocole Model Context Protocol
-- **4 outils de base** - Accès à la documentation Spring Boot essentielle
-- **Architecture TypeScript** - Code moderne avec types stricts
-- **Configuration Claude Desktop** - Intégration prête à l'emploi
-- **Tests automatisés** - Script de validation des fonctionnalités
-- **Documentation complète** - README avec instructions d'installation et usage
-
-### 🛠️ Outils MCP de base
-1. `search_spring_docs` - Recherche dans la documentation Spring Boot
-2. `get_spring_guide` - Récupération d'un guide spécifique
-3. `get_spring_reference` - Documentation de référence
-4. `search_spring_concepts` - Recherche de concepts Spring Boot
-
-### 📚 Sources de documentation initiales
-- Documentation Spring Boot officielle
-- Guides Spring.io sélectionnés
-- Base de connaissances des concepts Spring Boot
-
-### 🔧 Fonctionnalités techniques
-- Transport stdio pour communication MCP
-- Parsing HTML avec Cheerio
-- Conversion Markdown avec Turndown
-- Gestion d'erreurs robuste
-- Support des requêtes JSON-RPC 2.0
+### ✨ Initial Release
+- **Functional MCP server** - Complete Model Context Protocol implementation
+- **4 basic tools** - Access to essential Spring Boot documentation
+- **TypeScript architecture** - Modern code with strict types
+- **Claude Desktop configuration** - Ready-to-use integration
+- **Automated testing** - Functionality validation script
+- **Complete documentation** - README with installation and usage instructions
+
+### 🛠️ Basic MCP Tools
+1. `search_spring_docs` - Search Spring Boot documentation
+2. `get_spring_guide` - Retrieve specific guide
+3. `get_spring_reference` - Reference documentation
+4. `search_spring_concepts` - Search Spring Boot concepts
+
+### 📚 Initial Documentation Sources
+- Official Spring Boot documentation
+- Selected Spring.io guides
+- Spring Boot concepts knowledge base
+
+### 🔧 Technical Features
+- stdio transport for MCP communication
+- HTML parsing with Cheerio
+- Markdown conversion with Turndown
+- Robust error handling
+- JSON-RPC 2.0 request support
 
 ---
 
-## Format des versions
+## Version Format
 
-- **MAJOR** : Changements incompatibles de l'API
-- **MINOR** : Nouvelles fonctionnalités compatibles
-- **PATCH** : Corrections de bugs compatibles
+- **MAJOR**: Incompatible API changes
+- **MINOR**: Backward-compatible new features
+- **PATCH**: Backward-compatible bug fixes
 
-## Types de changements
+## Types of Changes
 
-- `✨ Ajouté` pour les nouvelles fonctionnalités
-- `🔧 Amélioré` pour les modifications de fonctionnalités existantes
-- `🐛 Corrigé` pour les corrections de bugs
-- `❌ Supprimé` pour les fonctionnalités supprimées
-- `⚠️ Déprécié` pour les fonctionnalités bientôt supprimées
-- `🔒 Sécurité` pour les corrections de vulnérabilités
+- `✨ Added` for new features
+- `🔧 Improved` for changes to existing functionality
+- `🐛 Fixed` for bug fixes
+- `❌ Removed` for removed features
+- `⚠️ Deprecated` for soon-to-be removed features
+- `🔒 Security` for vulnerability fixes

package/EXAMPLES.md

@@ -1,186 +0,0 @@
-# Exemples d'utilisation du serveur MCP Spring Documentation
-
-Ce fichier contient des exemples pratiques d'utilisation du serveur MCP Spring Documentation avec Claude Desktop.
-
-## 🚀 Scénarios d'utilisation
-
-### 1. Découverte des projets Spring
-
-**Question à Claude :**
-> "Quels sont les projets Spring disponibles pour la sécurité ?"
-
-**Outils utilisés :** `search_spring_projects`
-**Résultat :** Liste des projets Spring Security avec descriptions
-
----
-
-### 2. Apprentissage d'un nouveau projet Spring
-
-**Question à Claude :**
-> "Peux-tu m'expliquer le projet Spring Cloud ?"
-
-**Outils utilisés :** `get_spring_project`
-**Résultat :** Documentation complète de Spring Cloud
-
----
-
-### 3. Exploration des guides par domaine
-
-**Question à Claude :**
-> "Montre-moi tous les guides Spring Boot pour le développement web"
-
-**Outils utilisés :** `get_all_spring_guides`
-**Résultat :** Liste des guides web avec liens et descriptions
-
----
-
-### 4. Résolution d'un problème spécifique
-
-**Question à Claude :**
-> "Comment créer une API REST avec Spring Boot ?"
-
-**Outils utilisés :** `search_spring_docs`, `get_spring_guide`
-**Résultat :** Guide détaillé et documentation de référence
-
----
-
-### 5. Compréhension des concepts
-
-**Question à Claude :**
-> "Explique-moi l'auto-configuration dans Spring Boot"
-
-**Outils utilisés :** `search_spring_concepts`
-**Résultat :** Explication détaillée avec exemples
-
----
-
-## 🎯 Exemples de requêtes spécifiques
-
-### Recherche de documentation
-```
-Utilisateur: "Comment configurer Spring Security ?"
-Claude utilise: search_spring_docs("Spring Security configuration")
-```
-
-### Exploration de projets
-```
-Utilisateur: "Quels sont les projets Spring pour les données ?"
-Claude utilise: search_spring_projects("data")
-```
-
-### Guides spécialisés
-```
-Utilisateur: "Guides Spring Boot pour les tests"
-Claude utilise: get_all_spring_guides(category="Testing")
-```
-
-### Documentation de référence
-```
-Utilisateur: "Documentation Spring Boot pour la sécurité web"
-Claude utilise: get_spring_reference("security", "web")
-```
-
-### Concepts avancés
-```
-Utilisateur: "Qu'est-ce que Spring Actuator ?"
-Claude utilise: search_spring_concepts("actuator", "production")
-```
-
----
-
-## 💡 Conseils d'utilisation optimale
-
-### 1. Soyez spécifique dans vos questions
-- ❌ "Spring Boot"
-- ✅ "Comment configurer une base de données avec Spring Boot ?"
-
-### 2. Utilisez des mots-clés pertinents
-- ❌ "Aide"
-- ✅ "REST API", "JPA", "Security", "Testing"
-
-### 3. Explorez par domaine
-- "Projets Spring pour le cloud"
-- "Guides Spring Boot pour les microservices"
-- "Documentation Spring Security"
-
-### 4. Demandez des exemples pratiques
-- "Montre-moi un exemple de contrôleur REST"
-- "Comment tester une application Spring Boot ?"
-- "Configuration d'une base de données H2"
-
----
-
-## 🔧 Workflows recommandés
-
-### Workflow 1: Découverte d'un nouveau domaine
-1. **Rechercher les projets** → `search_spring_projects("domaine")`
-2. **Explorer un projet** → `get_spring_project("nom-projet")`
-3. **Trouver des guides** → `get_all_spring_guides(category="Domaine")`
-4. **Lire un guide spécifique** → `get_spring_guide("guide-id")`
-
-### Workflow 2: Résolution d'un problème
-1. **Rechercher dans la doc** → `search_spring_docs("problème")`
-2. **Comprendre les concepts** → `search_spring_concepts("concept")`
-3. **Consulter la référence** → `get_spring_reference("section")`
-4. **Suivre un guide pratique** → `get_spring_guide("guide-id")`
-
-### Workflow 3: Apprentissage structuré
-1. **Concepts de base** → `search_spring_concepts("core")`
-2. **Guides pour débutants** → `get_all_spring_guides(category="Getting Started")`
-3. **Documentation de référence** → `get_spring_reference("web")`
-4. **Projets avancés** → `search_spring_projects("advanced")`
-
----
-
-## 🌟 Cas d'usage avancés
-
-### Développement d'une API REST complète
-```
-1. "Quels sont les guides pour créer une API REST ?"
-2. "Montre-moi le guide pour créer un service REST"
-3. "Comment sécuriser une API REST avec Spring Security ?"
-4. "Documentation sur les tests d'API REST"
-5. "Concepts de production pour les API REST"
-```
-
-### Migration vers Spring Boot 3
-```
-1. "Quels sont les projets Spring compatibles avec Boot 3 ?"
-2. "Guide de migration Spring Boot 2 vers 3"
-3. "Nouvelles fonctionnalités Spring Boot 3"
-4. "Documentation de référence Spring Boot 3"
-```
-
-### Architecture microservices
-```
-1. "Projets Spring pour les microservices"
-2. "Guides Spring Cloud"
-3. "Concepts de configuration distribuée"
-4. "Documentation Spring Cloud Gateway"
-```
-
----
-
-## 📖 Types de réponses attendues
-
-### Listes de résultats (search_*)
-- Titres des ressources
-- Descriptions courtes
-- URLs directes
-- Types de contenu
-
-### Contenu détaillé (get_*)
-- Documentation complète en Markdown
-- Exemples de code
-- Configuration
-- Bonnes pratiques
-
-### Concepts (search_spring_concepts)
-- Définitions claires
-- Exemples concrets
-- Mots-clés associés
-- Cas d'usage
-
----
-
-*Ce serveur MCP vous donne accès à l'ensemble de l'écosystème Spring directement dans Claude Desktop !*

package/EXAMPLES_FR.md

@@ -0,0 +1,186 @@
+# Exemples d'utilisation du serveur MCP Spring Documentation
+
+Ce fichier contient des exemples pratiques d'utilisation du serveur MCP Spring Documentation avec Claude Desktop.
+
+## 🚀 Scénarios d'utilisation
+
+### 1. Découverte des projets Spring
+
+**Question à Claude :**
+> "Quels sont les projets Spring disponibles pour la sécurité ?"
+
+**Outils utilisés :** `search_spring_projects`
+**Résultat :** Liste des projets Spring Security avec descriptions
+
+---
+
+### 2. Apprentissage d'un nouveau projet Spring
+
+**Question à Claude :**
+> "Peux-tu m'expliquer le projet Spring Cloud ?"
+
+**Outils utilisés :** `get_spring_project`
+**Résultat :** Documentation complète de Spring Cloud
+
+---
+
+### 3. Exploration des guides par domaine
+
+**Question à Claude :**
+> "Montre-moi tous les guides Spring Boot pour le développement web"
+
+**Outils utilisés :** `get_all_spring_guides`
+**Résultat :** Liste des guides web avec liens et descriptions
+
+---
+
+### 4. Résolution d'un problème spécifique
+
+**Question à Claude :**
+> "Comment créer une API REST avec Spring Boot ?"
+
+**Outils utilisés :** `search_spring_docs`, `get_spring_guide`
+**Résultat :** Guide détaillé et documentation de référence
+
+---
+
+### 5. Compréhension des concepts
+
+**Question à Claude :**
+> "Explique-moi l'auto-configuration dans Spring Boot"
+
+**Outils utilisés :** `search_spring_concepts`
+**Résultat :** Explication détaillée avec exemples
+
+---
+
+## 🎯 Exemples de requêtes spécifiques
+
+### Recherche de documentation
+```
+Utilisateur: "Comment configurer Spring Security ?"
+Claude utilise: search_spring_docs("Spring Security configuration")
+```
+
+### Exploration de projets
+```
+Utilisateur: "Quels sont les projets Spring pour les données ?"
+Claude utilise: search_spring_projects("data")
+```
+
+### Guides spécialisés
+```
+Utilisateur: "Guides Spring Boot pour les tests"
+Claude utilise: get_all_spring_guides(category="Testing")
+```
+
+### Documentation de référence
+```
+Utilisateur: "Documentation Spring Boot pour la sécurité web"
+Claude utilise: get_spring_reference("security", "web")
+```
+
+### Concepts avancés
+```
+Utilisateur: "Qu'est-ce que Spring Actuator ?"
+Claude utilise: search_spring_concepts("actuator", "production")
+```
+
+---
+
+## 💡 Conseils d'utilisation optimale
+
+### 1. Soyez spécifique dans vos questions
+- ❌ "Spring Boot"
+- ✅ "Comment configurer une base de données avec Spring Boot ?"
+
+### 2. Utilisez des mots-clés pertinents
+- ❌ "Aide"
+- ✅ "REST API", "JPA", "Security", "Testing"
+
+### 3. Explorez par domaine
+- "Projets Spring pour le cloud"
+- "Guides Spring Boot pour les microservices"
+- "Documentation Spring Security"
+
+### 4. Demandez des exemples pratiques
+- "Montre-moi un exemple de contrôleur REST"
+- "Comment tester une application Spring Boot ?"
+- "Configuration d'une base de données H2"
+
+---
+
+## 🔧 Workflows recommandés
+
+### Workflow 1: Découverte d'un nouveau domaine
+1. **Rechercher les projets** → `search_spring_projects("domaine")`
+2. **Explorer un projet** → `get_spring_project("nom-projet")`
+3. **Trouver des guides** → `get_all_spring_guides(category="Domaine")`
+4. **Lire un guide spécifique** → `get_spring_guide("guide-id")`
+
+### Workflow 2: Résolution d'un problème
+1. **Rechercher dans la doc** → `search_spring_docs("problème")`
+2. **Comprendre les concepts** → `search_spring_concepts("concept")`
+3. **Consulter la référence** → `get_spring_reference("section")`
+4. **Suivre un guide pratique** → `get_spring_guide("guide-id")`
+
+### Workflow 3: Apprentissage structuré
+1. **Concepts de base** → `search_spring_concepts("core")`
+2. **Guides pour débutants** → `get_all_spring_guides(category="Getting Started")`
+3. **Documentation de référence** → `get_spring_reference("web")`
+4. **Projets avancés** → `search_spring_projects("advanced")`
+
+---
+
+## 🌟 Cas d'usage avancés
+
+### Développement d'une API REST complète
+```
+1. "Quels sont les guides pour créer une API REST ?"
+2. "Montre-moi le guide pour créer un service REST"
+3. "Comment sécuriser une API REST avec Spring Security ?"
+4. "Documentation sur les tests d'API REST"
+5. "Concepts de production pour les API REST"
+```
+
+### Migration vers Spring Boot 3
+```
+1. "Quels sont les projets Spring compatibles avec Boot 3 ?"
+2. "Guide de migration Spring Boot 2 vers 3"
+3. "Nouvelles fonctionnalités Spring Boot 3"
+4. "Documentation de référence Spring Boot 3"
+```
+
+### Architecture microservices
+```
+1. "Projets Spring pour les microservices"
+2. "Guides Spring Cloud"
+3. "Concepts de configuration distribuée"
+4. "Documentation Spring Cloud Gateway"
+```
+
+---
+
+## 📖 Types de réponses attendues
+
+### Listes de résultats (search_*)
+- Titres des ressources
+- Descriptions courtes
+- URLs directes
+- Types de contenu
+
+### Contenu détaillé (get_*)
+- Documentation complète en Markdown
+- Exemples de code
+- Configuration
+- Bonnes pratiques
+
+### Concepts (search_spring_concepts)
+- Définitions claires
+- Exemples concrets
+- Mots-clés associés
+- Cas d'usage
+
+---
+
+*Ce serveur MCP vous donne accès à l'ensemble de l'écosystème Spring directement dans Claude Desktop !*

package/INSTALL.md

@@ -1,123 +0,0 @@
-# 📦 Spring Documentation MCP Server - Installation publique
-
-Serveur MCP public pour accéder à toute la documentation Spring Boot et l'écosystème Spring complet.
-
-## 🚀 Installation rapide
-
-### Via npm (recommandé)
-```bash
-npm install -g @enokdev/springdocs-mcp
-```
-
-### Via npx (sans installation)
-```bash
-npx @enokdev/springdocs-mcp
-```
-
-## ⚡ Configuration Claude Desktop
-
-### 1. Installation globale
-```bash
-npm install -g @enokdev/springdocs-mcp
-```
-
-### 2. Configuration Claude Desktop
-Ajoutez ceci à votre `claude_desktop_config.json` :
-
-```json
-{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "springdocs-mcp"
-    }
-  }
-}
-```
-
-### 3. Localisation du fichier de configuration
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
-
-## 🛠️ Configuration avancée
-
-### Avec chemin spécifique
-```json
-{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "node",
-      "args": ["/path/to/global/node_modules/@enokdev/springdocs-mcp/build/index.js"]
-    }
-  }
-}
-```
-
-### Avec npx (sans installation globale)
-```json
-{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "npx",
-      "args": ["@enokdev/springdocs-mcp"]
-    }
-  }
-}
-```
-
-## 🔧 Outils disponibles
-
-Une fois configuré, vous aurez accès à 7 outils dans Claude Desktop :
-
-1. **`search_spring_docs`** - Recherche dans la documentation Spring Boot
-2. **`search_spring_projects`** - Recherche de projets Spring
-3. **`get_spring_project`** - Détails d'un projet Spring
-4. **`get_all_spring_guides`** - Liste des guides Spring
-5. **`get_spring_guide`** - Contenu d'un guide spécifique
-6. **`get_spring_reference`** - Documentation de référence
-7. **`search_spring_concepts`** - Recherche de concepts Spring Boot
-
-## 💡 Exemples d'utilisation
-
-Une fois installé, demandez à Claude :
-
-- *"Quels sont les projets Spring disponibles pour la sécurité ?"*
-- *"Montre-moi le guide pour créer une API REST avec Spring Boot"*
-- *"Comment configurer Spring Security ?"*
-- *"Explique-moi l'auto-configuration dans Spring Boot"*
-
-## 🔄 Mise à jour
-
-```bash
-npm update -g @enokdev/springdocs-mcp
-```
-
-## 🆘 Dépannage
-
-### Vérifier l'installation
-```bash
-springdocs-mcp --version
-```
-
-### Test manual
-```bash
-echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | springdocs-mcp
-```
-
-### Réinstallation
-```bash
-npm uninstall -g @enokdev/springdocs-mcp
-npm install -g @enokdev/springdocs-mcp
-```
-
-## 📚 Sources de documentation
-
-Ce serveur accède à :
-- **spring.io/projects** - Tous les projets Spring
-- **spring.io/guides** - Guides pratiques
-- **docs.spring.io** - Documentation de référence
-- **Base de connaissances intégrée** - Concepts Spring Boot
-
----
-
-**🌟 Profitez de l'accès complet à l'écosystème Spring directement dans Claude Desktop !**