@enokdev/springdocs-mcp 1.1.0 → 1.2.0

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/CHANGELOG_v1.2.0.md

@@ -0,0 +1,71 @@
+# 🆕 Changelog - Version 1.2.0
+
+## [1.2.0] - 2025-08-21
+
+### ✨ Added - JetBrains IDEs Support
+
+- **🛠️ JetBrains IDEs Integration**: Full support for all JetBrains IDEs
+  - IntelliJ IDEA (Ultimate & Community)
+  - WebStorm
+  - PyCharm (Professional & Community)
+  - PhpStorm, RubyMine, CLion, GoLand, Rider, DataGrip
+  - Android Studio
+
+- **🚀 Automatic Configuration Script**: `setup-jetbrains.sh`
+  - Detects all installed JetBrains IDEs
+  - Creates appropriate configuration files
+  - Works on macOS, Linux, and Windows
+  - Color-coded output and progress indicators
+
+- **📚 JetBrains Documentation**: New `JETBRAINS_SETUP.md`
+  - Complete setup instructions
+  - IDE-specific configurations
+  - Usage examples and troubleshooting
+  - Manual and automatic setup options
+
+- **🔧 Enhanced Scripts**:
+  - `npm run setup-jetbrains` - Configure JetBrains IDEs
+  - `npm run setup-all` - Configure all supported IDEs
+
+### 🔄 Improved
+
+- **📖 Enhanced README**: Added JetBrains configuration section
+- **⚙️ VS Code Settings**: Updated `.vscode/settings.json` with MCP configuration
+- **🛠️ Troubleshooting Guide**: Updated `TROUBLESHOOTING.md` with JetBrains support
+
+### 🎯 Use Cases
+
+Now developers can use the Spring Documentation MCP Server in:
+- **Claude Desktop** - Chat interface
+- **VS Code** - With Claude extension
+- **JetBrains IDEs** - Integrated AI assistance
+- **Command Line** - Direct MCP server access
+
+### 🔧 Technical Details
+
+- Cross-platform configuration detection
+- IDE version-specific setup
+- XML and JSON configuration formats
+- Automatic path resolution for different OS
+
+---
+
+## Previous Versions
+
+### [1.1.1] - 2025-08-21
+- 📝 Documentation internationalization (English)
+- 🌍 Public distribution preparation
+
+### [1.1.0] - 2025-08-21
+- ✨ Extended to complete Spring ecosystem
+- 🆕 Added 3 new MCP tools (total: 7 tools)
+- 🌐 Spring.io/projects integration
+
+### [1.0.0] - 2025-08-21
+- 🎉 Initial release
+- 📚 Basic Spring Boot documentation access
+- 🛠️ 4 core MCP tools
+
+---
+
+**Full Changelog**: https://github.com/tky0065/springdocs-mcp/compare/v1.1.1...v1.2.0

package/EXAMPLES.md

@@ -1,186 +1,186 @@
-# Exemples d'utilisation du serveur MCP Spring Documentation
+# Usage Examples - Spring Documentation MCP Server
 
-Ce fichier contient des exemples pratiques d'utilisation du serveur MCP Spring Documentation avec Claude Desktop.
+This file contains practical usage examples for the Spring Documentation MCP Server with Claude Desktop.
 
-## 🚀 Scénarios d'utilisation
+## 🚀 Usage Scenarios
 
-### 1. Découverte des projets Spring
+### 1. Discovering Spring Projects
 
-**Question à Claude :**
-> "Quels sont les projets Spring disponibles pour la sécurité ?"
+**Question to Claude:**
+> "What Spring projects are available for security?"
 
-**Outils utilisés :** `search_spring_projects`
-**Résultat :** Liste des projets Spring Security avec descriptions
+**Tools used:** `search_spring_projects`
+**Result:** List of Spring Security projects with descriptions
 
 ---
 
-### 2. Apprentissage d'un nouveau projet Spring
+### 2. Learning a New Spring Project
 
-**Question à Claude :**
-> "Peux-tu m'expliquer le projet Spring Cloud ?"
+**Question to Claude:**
+> "Can you explain the Spring Cloud project?"
 
-**Outils utilisés :** `get_spring_project`
-**Résultat :** Documentation complète de Spring Cloud
+**Tools used:** `get_spring_project`
+**Result:** Complete Spring Cloud documentation
 
 ---
 
-### 3. Exploration des guides par domaine
+### 3. Exploring Guides by Domain
 
-**Question à Claude :**
-> "Montre-moi tous les guides Spring Boot pour le développement web"
+**Question to Claude:**
+> "Show me all Spring Boot guides for web development"
 
-**Outils utilisés :** `get_all_spring_guides`
-**Résultat :** Liste des guides web avec liens et descriptions
+**Tools used:** `get_all_spring_guides`
+**Result:** List of web guides with links and descriptions
 
 ---
 
-### 4. Résolution d'un problème spécifique
+### 4. Solving a Specific Problem
 
-**Question à Claude :**
-> "Comment créer une API REST avec Spring Boot ?"
+**Question to Claude:**
+> "How do I create a REST API with Spring Boot?"
 
-**Outils utilisés :** `search_spring_docs`, `get_spring_guide`
-**Résultat :** Guide détaillé et documentation de référence
+**Tools used:** `search_spring_docs`, `get_spring_guide`
+**Result:** Detailed guide and reference documentation
 
 ---
 
-### 5. Compréhension des concepts
+### 5. Understanding Concepts
 
-**Question à Claude :**
-> "Explique-moi l'auto-configuration dans Spring Boot"
+**Question to Claude:**
+> "Explain Spring Boot auto-configuration to me"
 
-**Outils utilisés :** `search_spring_concepts`
-**Résultat :** Explication détaillée avec exemples
+**Tools used:** `search_spring_concepts`
+**Result:** Detailed explanation with examples
 
 ---
 
-## 🎯 Exemples de requêtes spécifiques
+## 🎯 Specific Query Examples
 
-### Recherche de documentation
+### Documentation Search
 ```
-Utilisateur: "Comment configurer Spring Security ?"
-Claude utilise: search_spring_docs("Spring Security configuration")
+User: "How to configure Spring Security?"
+Claude uses: search_spring_docs("Spring Security configuration")
 ```
 
-### Exploration de projets
+### Project Exploration
 ```
-Utilisateur: "Quels sont les projets Spring pour les données ?"
-Claude utilise: search_spring_projects("data")
+User: "What are the Spring projects for data?"
+Claude uses: search_spring_projects("data")
 ```
 
-### Guides spécialisés
+### Specialized Guides
 ```
-Utilisateur: "Guides Spring Boot pour les tests"
-Claude utilise: get_all_spring_guides(category="Testing")
+User: "Spring Boot guides for testing"
+Claude uses: get_all_spring_guides(category="Testing")
 ```
 
-### Documentation de référence
+### Reference Documentation
 ```
-Utilisateur: "Documentation Spring Boot pour la sécurité web"
-Claude utilise: get_spring_reference("security", "web")
+User: "Spring Boot documentation for web security"
+Claude uses: get_spring_reference("security", "web")
 ```
 
-### Concepts avancés
+### Advanced Concepts
 ```
-Utilisateur: "Qu'est-ce que Spring Actuator ?"
-Claude utilise: search_spring_concepts("actuator", "production")
+User: "What is Spring Actuator?"
+Claude uses: search_spring_concepts("actuator", "production")
 ```
 
 ---
 
-## 💡 Conseils d'utilisation optimale
+## 💡 Optimal Usage Tips
 
-### 1. Soyez spécifique dans vos questions
+### 1. Be Specific in Your Questions
 - ❌ "Spring Boot"
-- ✅ "Comment configurer une base de données avec Spring Boot ?"
+- ✅ "How to configure a database with Spring Boot?"
 
-### 2. Utilisez des mots-clés pertinents
-- ❌ "Aide"
+### 2. Use Relevant Keywords
+- ❌ "Help"
 - ✅ "REST API", "JPA", "Security", "Testing"
 
-### 3. Explorez par domaine
-- "Projets Spring pour le cloud"
-- "Guides Spring Boot pour les microservices"
-- "Documentation Spring Security"
+### 3. Explore by Domain
+- "Spring projects for cloud"
+- "Spring Boot guides for microservices"
+- "Spring Security documentation"
 
-### 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"
+### 4. Ask for Practical Examples
+- "Show me an example of a REST controller"
+- "How to test a Spring Boot application?"
+- "H2 database configuration"
 
 ---
 
-## 🔧 Workflows recommandés
+## 🔧 Recommended Workflows
 
-### 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 1: Discovering a New Domain
+1. **Search projects** → `search_spring_projects("domain")`
+2. **Explore a project** → `get_spring_project("project-name")`
+3. **Find guides** → `get_all_spring_guides(category="Domain")`
+4. **Read a specific guide** → `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 2: Problem Solving
+1. **Search documentation** → `search_spring_docs("problem")`
+2. **Understand concepts** → `search_spring_concepts("concept")`
+3. **Consult reference** → `get_spring_reference("section")`
+4. **Follow practical guide** → `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")`
+### Workflow 3: Structured Learning
+1. **Basic concepts** → `search_spring_concepts("core")`
+2. **Beginner guides** → `get_all_spring_guides(category="Getting Started")`
+3. **Reference documentation** → `get_spring_reference("web")`
+4. **Advanced projects** → `search_spring_projects("advanced")`
 
 ---
 
-## 🌟 Cas d'usage avancés
+## 🌟 Advanced Use Cases
 
-### Développement d'une API REST complète
+### Developing a Complete REST API
 ```
-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"
+1. "What are the guides for creating a REST API?"
+2. "Show me the guide for creating a REST service"
+3. "How to secure a REST API with Spring Security?"
+4. "Documentation on REST API testing"
+5. "Production concepts for REST APIs"
 ```
 
-### Migration vers Spring Boot 3
+### Migration to 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"
+1. "What Spring projects are compatible with Boot 3?"
+2. "Spring Boot 2 to 3 migration guide"
+3. "Spring Boot 3 new features"
+4. "Spring Boot 3 reference documentation"
 ```
 
-### Architecture microservices
+### Microservices Architecture
 ```
-1. "Projets Spring pour les microservices"
-2. "Guides Spring Cloud"
-3. "Concepts de configuration distribuée"
-4. "Documentation Spring Cloud Gateway"
+1. "Spring projects for microservices"
+2. "Spring Cloud guides"
+3. "Distributed configuration concepts"
+4. "Spring Cloud Gateway documentation"
 ```
 
 ---
 
-## 📖 Types de réponses attendues
+## 📖 Expected Response Types
 
-### Listes de résultats (search_*)
-- Titres des ressources
-- Descriptions courtes
-- URLs directes
-- Types de contenu
+### Search Results (search_*)
+- Resource titles
+- Short descriptions
+- Direct URLs
+- Content types
 
-### Contenu détaillé (get_*)
-- Documentation complète en Markdown
-- Exemples de code
+### Detailed Content (get_*)
+- Complete documentation in Markdown
+- Code examples
 - Configuration
-- Bonnes pratiques
+- Best practices
 
 ### Concepts (search_spring_concepts)
-- Définitions claires
-- Exemples concrets
-- Mots-clés associés
-- Cas d'usage
+- Clear definitions
+- Concrete examples
+- Associated keywords
+- Use cases
 
 ---
 
-*Ce serveur MCP vous donne accès à l'ensemble de l'écosystème Spring directement dans Claude Desktop !*
+*This MCP server gives you access to the entire Spring ecosystem directly in Claude Desktop!*