@enokdev/springdocs-mcp 1.1.0 → 1.2.0

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,28 +1,28 @@
-# 📦 Spring Documentation MCP Server - Installation publique
+# 📦 Spring Documentation MCP Server - Public Installation
 
-Serveur MCP public pour accéder à toute la documentation Spring Boot et l'écosystème Spring complet.
+Public MCP server for accessing complete Spring Boot documentation and the Spring ecosystem.
 
-## 🚀 Installation rapide
+## 🚀 Quick Installation
 
-### Via npm (recommandé)
+### Via npm (recommended)
 ```bash
 npm install -g @enokdev/springdocs-mcp
 ```
 
-### Via npx (sans installation)
+### Via npx (without installation)
 ```bash
 npx @enokdev/springdocs-mcp
 ```
 
-## ⚡ Configuration Claude Desktop
+## ⚡ Claude Desktop Configuration
 
-### 1. Installation globale
+### 1. Global Installation
 ```bash
 npm install -g @enokdev/springdocs-mcp
 ```
 
-### 2. Configuration Claude Desktop
-Ajoutez ceci à votre `claude_desktop_config.json` :
+### 2. Claude Desktop Configuration
+Add this to your `claude_desktop_config.json`:
 
 ```json
 {
@@ -34,14 +34,14 @@ Ajoutez ceci à votre `claude_desktop_config.json` :
 }
 ```
 
-### 3. Localisation du fichier de configuration
+### 3. Configuration File Location
 - **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
+## 🛠️ Advanced Configuration
 
-### Avec chemin spécifique
+### With specific path
 ```json
 {
   "mcpServers": {
@@ -53,7 +53,7 @@ Ajoutez ceci à votre `claude_desktop_config.json` :
 }
 ```
 
-### Avec npx (sans installation globale)
+### With npx (without global installation)
 ```json
 {
   "mcpServers": {
@@ -65,59 +65,59 @@ Ajoutez ceci à votre `claude_desktop_config.json` :
 }
 ```
 
-## 🔧 Outils disponibles
+## 🔧 Available Tools
 
-Une fois configuré, vous aurez accès à 7 outils dans Claude Desktop :
+Once configured, you'll have access to 7 tools in 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
+1. **`search_spring_docs`** - Search Spring Boot documentation
+2. **`search_spring_projects`** - Search Spring projects
+3. **`get_spring_project`** - Get Spring project details
+4. **`get_all_spring_guides`** - List Spring guides
+5. **`get_spring_guide`** - Get specific guide content
+6. **`get_spring_reference`** - Get reference documentation
+7. **`search_spring_concepts`** - Search Spring Boot concepts
 
-## 💡 Exemples d'utilisation
+## 💡 Usage Examples
 
-Une fois installé, demandez à Claude :
+Once installed, ask 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"*
+- *"What Spring projects are available for security?"*
+- *"Show me the guide for creating a REST API with Spring Boot"*
+- *"How do I configure Spring Security?"*
+- *"Explain Spring Boot auto-configuration"*
 
-## 🔄 Mise à jour
+## 🔄 Updates
 
 ```bash
 npm update -g @enokdev/springdocs-mcp
 ```
 
-## 🆘 Dépannage
+## 🆘 Troubleshooting
 
-### Vérifier l'installation
+### Check installation
 ```bash
 springdocs-mcp --version
 ```
 
-### Test manual
+### Manual test
 ```bash
 echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | springdocs-mcp
 ```
 
-### Réinstallation
+### Reinstallation
 ```bash
 npm uninstall -g @enokdev/springdocs-mcp
 npm install -g @enokdev/springdocs-mcp
 ```
 
-## 📚 Sources de documentation
+## 📚 Documentation Sources
 
-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
+This server accesses:
+- **spring.io/projects** - All Spring projects
+- **spring.io/guides** - Practical guides
+- **docs.spring.io** - Reference documentation
+- **Built-in knowledge base** - Spring Boot concepts
 
 ---
 
-**🌟 Profitez de l'accès complet à l'écosystème Spring directement dans Claude Desktop !**
+**🌟 Enjoy complete access to the Spring ecosystem directly in Claude Desktop!**

package/INSTALL_FR.md

@@ -0,0 +1,123 @@
+# 📦 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 !**

package/JETBRAINS_SETUP.md

@@ -0,0 +1,171 @@
+# 🚀 Configuration pour IDEs JetBrains
+
+## 📋 IDEs JetBrains supportés
+
+- **IntelliJ IDEA** (Ultimate & Community)
+- **WebStorm**
+- **PyCharm** (Professional & Community)
+- **PhpStorm**
+- **RubyMine**
+- **CLion**
+- **GoLand**
+- **Rider**
+- **DataGrip**
+- **Android Studio**
+
+## ⚙️ Configuration
+
+### Option 1: Via le Plugin Claude (Recommandé)
+
+1. **Installer le plugin Claude** depuis JetBrains Marketplace
+2. **Configurer les serveurs MCP** dans Settings
+
+**Chemin:** `Settings → Tools → Claude → MCP Servers`
+
+**Configuration:**
+```json
+{
+  "spring-docs": {
+    "command": "/opt/homebrew/bin/springdocs-mcp"
+  }
+}
+```
+
+### Option 2: Configuration manuelle
+
+**Fichier de configuration JetBrains:**
+`~/.jetbrains/claude_mcp_config.json`
+
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "/opt/homebrew/bin/springdocs-mcp",
+      "description": "Spring Documentation MCP Server - Access to complete Spring ecosystem",
+      "timeout": 30000
+    }
+  }
+}
+```
+
+### Option 3: Configuration par IDE
+
+#### IntelliJ IDEA
+**Fichier:** `~/.IntelliJIdea/config/options/claude.xml`
+
+```xml
+<application>
+  <component name="ClaudeSettings">
+    <option name="mcpServers">
+      <map>
+        <entry key="spring-docs">
+          <value>
+            <MCPServerConfig>
+              <option name="command" value="/opt/homebrew/bin/springdocs-mcp" />
+              <option name="description" value="Spring Documentation" />
+            </MCPServerConfig>
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+</application>
+```
+
+#### WebStorm
+**Fichier:** `~/.WebStorm/config/options/claude.xml`
+
+#### PyCharm
+**Fichier:** `~/.PyCharm/config/options/claude.xml`
+
+## 🔧 Script d'installation automatique
+
+Créons un script pour configurer automatiquement tous vos IDEs JetBrains :
+
+```bash
+#!/bin/bash
+./setup-jetbrains.sh
+```
+
+## 🎯 Utilisation dans JetBrains IDEs
+
+### 1. Accès via Chat AI
+
+Dans votre IDE JetBrains avec Claude activé :
+
+```
+Quels sont les projets Spring pour la sécurité ?
+```
+
+### 2. Aide contextuelle
+
+Sélectionnez du code Spring et demandez :
+
+```
+Comment améliorer cette configuration Spring Boot ?
+```
+
+### 3. Documentation instantanée
+
+```
+Montre-moi le guide Spring Boot pour les APIs REST
+```
+
+## 🛠️ Outils disponibles dans JetBrains
+
+Tous les 7 outils MCP seront disponibles :
+
+1. **search_spring_docs** - Recherche documentation
+2. **search_spring_projects** - Projets Spring
+3. **get_spring_project** - Détails projet
+4. **get_all_spring_guides** - Liste guides
+5. **get_spring_guide** - Contenu guide
+6. **get_spring_reference** - Référence
+7. **search_spring_concepts** - Concepts
+
+## 📝 Exemples d'utilisation
+
+### Développement Spring Boot dans IntelliJ
+
+```java
+@RestController
+public class UserController {
+    // Demander à Claude : "Montre-moi les meilleures pratiques pour ce contrôleur"
+}
+```
+
+### Configuration dans application.yml
+
+```yaml
+spring:
+  # Demander : "Quelles sont les options de configuration disponibles ?"
+```
+
+## 🔍 Dépannage JetBrains
+
+### Plugin Claude non visible
+1. Vérifier que le plugin est installé
+2. Redémarrer l'IDE
+3. Vérifier les permissions
+
+### MCP Server non connecté
+1. Vérifier le chemin : `/opt/homebrew/bin/springdocs-mcp`
+2. Tester la commande dans le terminal
+3. Vérifier les logs de l'IDE
+
+## 📍 Emplacements des configurations
+
+### macOS
+- **IntelliJ IDEA:** `~/Library/Application Support/JetBrains/IntelliJIdea*/`
+- **WebStorm:** `~/Library/Application Support/JetBrains/WebStorm*/`
+- **PyCharm:** `~/Library/Application Support/JetBrains/PyCharm*/`
+
+### Windows
+- **Tous IDEs:** `%APPDATA%\JetBrains\[IDE_NAME]*\`
+
+### Linux
+- **Tous IDEs:** `~/.config/JetBrains/[IDE_NAME]*/`
+
+---
+
+**Note:** La disponibilité exacte dépend de la version du plugin Claude pour JetBrains. Consultez la documentation officielle du plugin pour les détails spécifiques à votre IDE.