@enokdev/springdocs-mcp 1.1.1 → 1.2.0

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

@@ -0,0 +1,186 @@
+# Usage Examples - Spring Documentation MCP Server
+
+This file contains practical usage examples for the Spring Documentation MCP Server with Claude Desktop.
+
+## 🚀 Usage Scenarios
+
+### 1. Discovering Spring Projects
+
+**Question to Claude:**
+> "What Spring projects are available for security?"
+
+**Tools used:** `search_spring_projects`
+**Result:** List of Spring Security projects with descriptions
+
+---
+
+### 2. Learning a New Spring Project
+
+**Question to Claude:**
+> "Can you explain the Spring Cloud project?"
+
+**Tools used:** `get_spring_project`
+**Result:** Complete Spring Cloud documentation
+
+---
+
+### 3. Exploring Guides by Domain
+
+**Question to Claude:**
+> "Show me all Spring Boot guides for web development"
+
+**Tools used:** `get_all_spring_guides`
+**Result:** List of web guides with links and descriptions
+
+---
+
+### 4. Solving a Specific Problem
+
+**Question to Claude:**
+> "How do I create a REST API with Spring Boot?"
+
+**Tools used:** `search_spring_docs`, `get_spring_guide`
+**Result:** Detailed guide and reference documentation
+
+---
+
+### 5. Understanding Concepts
+
+**Question to Claude:**
+> "Explain Spring Boot auto-configuration to me"
+
+**Tools used:** `search_spring_concepts`
+**Result:** Detailed explanation with examples
+
+---
+
+## 🎯 Specific Query Examples
+
+### Documentation Search
+```
+User: "How to configure Spring Security?"
+Claude uses: search_spring_docs("Spring Security configuration")
+```
+
+### Project Exploration
+```
+User: "What are the Spring projects for data?"
+Claude uses: search_spring_projects("data")
+```
+
+### Specialized Guides
+```
+User: "Spring Boot guides for testing"
+Claude uses: get_all_spring_guides(category="Testing")
+```
+
+### Reference Documentation
+```
+User: "Spring Boot documentation for web security"
+Claude uses: get_spring_reference("security", "web")
+```
+
+### Advanced Concepts
+```
+User: "What is Spring Actuator?"
+Claude uses: search_spring_concepts("actuator", "production")
+```
+
+---
+
+## 💡 Optimal Usage Tips
+
+### 1. Be Specific in Your Questions
+- ❌ "Spring Boot"
+- ✅ "How to configure a database with Spring Boot?"
+
+### 2. Use Relevant Keywords
+- ❌ "Help"
+- ✅ "REST API", "JPA", "Security", "Testing"
+
+### 3. Explore by Domain
+- "Spring projects for cloud"
+- "Spring Boot guides for microservices"
+- "Spring Security documentation"
+
+### 4. Ask for Practical Examples
+- "Show me an example of a REST controller"
+- "How to test a Spring Boot application?"
+- "H2 database configuration"
+
+---
+
+## 🔧 Recommended Workflows
+
+### 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: 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: 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")`
+
+---
+
+## 🌟 Advanced Use Cases
+
+### Developing a Complete REST API
+```
+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 to 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"
+```
+
+### Microservices Architecture
+```
+1. "Spring projects for microservices"
+2. "Spring Cloud guides"
+3. "Distributed configuration concepts"
+4. "Spring Cloud Gateway documentation"
+```
+
+---
+
+## 📖 Expected Response Types
+
+### Search Results (search_*)
+- Resource titles
+- Short descriptions
+- Direct URLs
+- Content types
+
+### Detailed Content (get_*)
+- Complete documentation in Markdown
+- Code examples
+- Configuration
+- Best practices
+
+### Concepts (search_spring_concepts)
+- Clear definitions
+- Concrete examples
+- Associated keywords
+- Use cases
+
+---
+
+*This MCP server gives you access to the entire Spring ecosystem directly in Claude Desktop!*

package/INSTALL.md

@@ -0,0 +1,123 @@
+# 📦 Spring Documentation MCP Server - Public Installation
+
+Public MCP server for accessing complete Spring Boot documentation and the Spring ecosystem.
+
+## 🚀 Quick Installation
+
+### Via npm (recommended)
+```bash
+npm install -g @enokdev/springdocs-mcp
+```
+
+### Via npx (without installation)
+```bash
+npx @enokdev/springdocs-mcp
+```
+
+## ⚡ Claude Desktop Configuration
+
+### 1. Global Installation
+```bash
+npm install -g @enokdev/springdocs-mcp
+```
+
+### 2. Claude Desktop Configuration
+Add this to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"
+    }
+  }
+}
+```
+
+### 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`
+
+## 🛠️ Advanced Configuration
+
+### With specific path
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "node",
+      "args": ["/path/to/global/node_modules/@enokdev/springdocs-mcp/build/index.js"]
+    }
+  }
+}
+```
+
+### With npx (without global installation)
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "npx",
+      "args": ["@enokdev/springdocs-mcp"]
+    }
+  }
+}
+```
+
+## 🔧 Available Tools
+
+Once configured, you'll have access to 7 tools in Claude Desktop:
+
+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
+
+## 💡 Usage Examples
+
+Once installed, ask Claude:
+
+- *"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"*
+
+## 🔄 Updates
+
+```bash
+npm update -g @enokdev/springdocs-mcp
+```
+
+## 🆘 Troubleshooting
+
+### Check installation
+```bash
+springdocs-mcp --version
+```
+
+### Manual test
+```bash
+echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | springdocs-mcp
+```
+
+### Reinstallation
+```bash
+npm uninstall -g @enokdev/springdocs-mcp
+npm install -g @enokdev/springdocs-mcp
+```
+
+## 📚 Documentation Sources
+
+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
+
+---
+
+**🌟 Enjoy complete access to the Spring ecosystem directly in 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.

package/README.md

@@ -128,6 +128,44 @@ To use this server with Claude Desktop, add the following configuration to your
 - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
 - **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`
 
+## 🛠️ Configuration with JetBrains IDEs
+
+### Automatic Setup (Recommended)
+
+Run the automatic configuration script:
+
+```bash
+./setup-jetbrains.sh
+```
+
+This will configure the MCP server for all your installed JetBrains IDEs:
+- **IntelliJ IDEA** (Ultimate & Community)
+- **WebStorm**
+- **PyCharm** (Professional & Community)
+- **PhpStorm**, **RubyMine**, **CLion**, **GoLand**, **Rider**, **DataGrip**
+
+### Manual Configuration
+
+Add to your IDE's Claude plugin configuration:
+
+```json
+{
+  "spring-docs": {
+    "command": "/opt/homebrew/bin/springdocs-mcp",
+    "description": "Spring Documentation MCP Server"
+  }
+}
+```
+
+### Usage in JetBrains IDEs
+
+Once configured, you can ask Claude in your IDE:
+- "What Spring projects are available for security?"
+- "Show me the Spring Boot REST API guide"
+- "Explain Spring Boot auto-configuration"
+
+See [JETBRAINS_SETUP.md](JETBRAINS_SETUP.md) for detailed instructions.
+
 ## 📚 Usage Examples
 
 ### General search

package/RELEASE_NOTES_v1.2.0.md

@@ -0,0 +1,138 @@
+# 🚀 Spring Documentation MCP Server v1.2.0 - Support JetBrains IDEs
+
+## 🎉 Nouveautés de la version 1.2.0
+
+### ✨ Support complet des IDEs JetBrains
+
+Votre serveur MCP Spring Documentation est maintenant compatible avec **tous les IDEs JetBrains** :
+
+- ✅ **IntelliJ IDEA** (Ultimate & Community)
+- ✅ **WebStorm** 
+- ✅ **PyCharm** (Professional & Community)
+- ✅ **PhpStorm**
+- ✅ **RubyMine**
+- ✅ **CLion**
+- ✅ **GoLand**
+- ✅ **Rider**
+- ✅ **DataGrip**
+- ✅ **Android Studio**
+
+## 🛠️ Installation et Configuration
+
+### 1. Mise à jour du package (si déjà installé)
+
+```bash
+npm update -g @enokdev/springdocs-mcp
+```
+
+### 2. Configuration automatique JetBrains
+
+```bash
+cd /path/to/springdocs-mcp
+./setup-jetbrains.sh
+```
+
+### 3. Vérification de la configuration
+
+```bash
+./test-jetbrains.sh
+```
+
+## 🎯 Utilisation dans vos IDEs
+
+### Claude Desktop
+✅ **Déjà configuré** - Continuez à utiliser comme avant
+
+### VS Code
+✅ **Déjà configuré** - Extension Claude avec MCP
+
+### JetBrains IDEs (NOUVEAU!)
+🆕 **Nouvellement supporté** :
+
+1. **Installer le plugin Claude** dans votre IDE JetBrains
+2. **Redémarrer l'IDE** après la configuration automatique
+3. **Tester** avec une question Spring dans le chat Claude
+
+## 💬 Exemples d'utilisation JetBrains
+
+### Dans IntelliJ IDEA
+```
+Vous: "Quels sont les projets Spring pour la sécurité ?"
+Claude: [Utilise search_spring_projects("security")]
+```
+
+### Dans WebStorm
+```
+Vous: "Comment créer une API REST avec Spring Boot ?"
+Claude: [Utilise get_spring_guide("gs-rest-service")]
+```
+
+### Dans GoLand
+```
+Vous: "Documentation Spring Boot pour les microservices"
+Claude: [Utilise search_spring_concepts("microservices")]
+```
+
+## 🔧 Tous vos outils MCP Spring disponibles
+
+1. **search_spring_docs** - Recherche documentation
+2. **search_spring_projects** - Projets Spring ecosystem
+3. **get_spring_project** - Détails d'un projet
+4. **get_all_spring_guides** - Liste des guides
+5. **get_spring_guide** - Contenu guide complet
+6. **get_spring_reference** - Documentation référence
+7. **search_spring_concepts** - Concepts Spring Boot
+
+## 📍 Où utiliser maintenant
+
+| Environnement | Status | Configuration |
+|---------------|--------|---------------|
+| **Claude Desktop** | ✅ Actif | `claude_desktop_config.json` |
+| **VS Code** | ✅ Actif | Extension Claude |
+| **IntelliJ IDEA** | 🆕 Nouveau | Plugin Claude + XML config |
+| **WebStorm** | 🆕 Nouveau | Plugin Claude + XML config |
+| **GoLand** | 🆕 Nouveau | Plugin Claude + XML config |
+| **PyCharm** | 🆕 Nouveau | Plugin Claude + XML config |
+| **Autres JetBrains** | 🆕 Nouveau | Plugin Claude + XML config |
+
+## 🔄 Migration depuis v1.1.1
+
+**Aucune action requise** pour vos configurations existantes :
+- ✅ Claude Desktop continue de fonctionner
+- ✅ VS Code continue de fonctionner
+- 🆕 JetBrains IDEs maintenant supportés en plus
+
+## 🛠️ Dépannage
+
+### JetBrains IDEs
+Si les outils n'apparaissent pas :
+
+1. **Vérifier le plugin Claude** est installé
+2. **Redémarrer l'IDE** complètement
+3. **Vérifier la configuration** : `./test-jetbrains.sh`
+4. **Consulter** `JETBRAINS_SETUP.md` pour les détails
+
+### Claude Desktop / VS Code
+Si problème existant :
+
+1. **Consulter** `TROUBLESHOOTING.md`
+2. **Exécuter** `./diagnostic.sh`
+
+## 🎊 Profitez de votre Spring Documentation
+
+Vous avez maintenant accès à **toute la documentation Spring** dans **tous vos environnements de développement** !
+
+- 📚 **Documentation complète** Spring Boot + écosystème
+- 🛠️ **7 outils MCP puissants**
+- 🌐 **Support multi-plateforme** (Claude Desktop, VS Code, JetBrains)
+- ⚡ **Accès instantané** à spring.io/projects et guides
+
+---
+
+**🔗 Liens utiles :**
+- 📖 [Documentation complète](README.md)
+- 🛠️ [Configuration JetBrains](JETBRAINS_SETUP.md)
+- 🔧 [Dépannage](TROUBLESHOOTING.md)
+- 📦 [npm Package](https://www.npmjs.com/package/@enokdev/springdocs-mcp)
+
+**Made with ❤️ by [EnokDev](https://github.com/tky0065)**

package/TROUBLESHOOTING.md

@@ -0,0 +1,163 @@
+# 🔧 Guide de Dépannage - Spring Documentation MCP Server
+
+## 🚨 Problème : Les outils MCP n'apparaissent pas dans Claude Desktop
+
+### ✅ Vérifications de base
+
+1. **Vérifier l'installation du package**
+   ```bash
+   npm list -g @enokdev/springdocs-mcp
+   ```
+   Devrait afficher : `@enokdev/springdocs-mcp@1.1.1`
+
+2. **Vérifier la commande globale**
+   ```bash
+   which springdocs-mcp
+   ```
+   Devrait afficher : `/opt/homebrew/bin/springdocs-mcp`
+
+3. **Tester le serveur localement**
+   ```bash
+   echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}' | springdocs-mcp
+   ```
+
+### 🔧 Solutions étape par étape
+
+#### Solution 1 : Configuration Claude Desktop (Recommandée)
+
+**Fichier :** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "/opt/homebrew/bin/springdocs-mcp"
+    }
+  }
+}
+```
+
+#### Solution 2 : Configuration alternative (Développement)
+
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "node",
+      "args": ["/path/to/springdocs-mcp/build/index.js"]
+    }
+  }
+}
+```
+
+#### Solution 3 : Réinstallation complète
+
+```bash
+# Désinstaller
+npm uninstall -g @enokdev/springdocs-mcp
+
+# Nettoyer le cache
+npm cache clean --force
+
+# Réinstaller
+npm install -g @enokdev/springdocs-mcp
+
+# Vérifier
+springdocs-mcp --help
+```
+
+### 🔍 Diagnostic automatique
+
+Utilisez le script de diagnostic :
+
+```bash
+./diagnostic.sh
+```
+
+### 📋 Checklist de dépannage
+
+- [ ] Package installé globalement
+- [ ] Lien symbolique existe dans `/opt/homebrew/bin/`
+- [ ] Fichier exécutable avec permissions correctes
+- [ ] Configuration JSON valide (pas de virgules en trop)
+- [ ] Chemin absolu utilisé dans la configuration
+- [ ] Claude Desktop redémarré après modification config
+
+### 🚫 Erreurs communes
+
+#### JSON invalide
+❌ **Problème :**
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"
+    },  // <- virgule en trop
+  }
+}
+```
+
+✅ **Solution :**
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"
+    }
+  }
+}
+```
+
+#### Chemin relatif
+❌ **Problème :**
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"  // <- peut ne pas être trouvé
+    }
+  }
+}
+```
+
+✅ **Solution :**
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "/opt/homebrew/bin/springdocs-mcp"  // <- chemin absolu
+    }
+  }
+}
+```
+
+### 🔄 Redémarrage requis
+
+Après modification de la configuration :
+
+1. **Fermer complètement Claude Desktop**
+2. **Attendre 5 secondes**
+3. **Relancer Claude Desktop**
+4. **Vérifier la présence des outils dans le menu**
+
+### 📍 Emplacements des fichiers
+
+- **Configuration Claude Desktop :** `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Executable global :** `/opt/homebrew/bin/springdocs-mcp`
+- **Package installé :** `/opt/homebrew/lib/node_modules/@enokdev/springdocs-mcp/`
+
+### 🆘 Si rien ne fonctionne
+
+1. **Vérifier les logs de Claude Desktop** (si disponibles)
+2. **Tester avec une configuration minimale**
+3. **Utiliser le mode développement avec chemin absolu**
+4. **Contacter le support ou ouvrir une issue GitHub**
+
+### 📞 Support
+
+- **GitHub Issues :** https://github.com/tky0065/springdocs-mcp/issues
+- **npm Package :** https://www.npmjs.com/package/@enokdev/springdocs-mcp
+
+---
+
+**Note :** Ce serveur MCP fournit 7 outils pour explorer la documentation Spring. Une fois configuré correctement, vous devriez voir apparaître les outils Spring dans l'interface Claude Desktop.

package/claude_desktop_config.json

@@ -1,8 +1,7 @@
 {
   "mcpServers": {
-    "springboot-docs": {
-      "command": "node",
-      "args": ["/Users/yacoubakone/Documents/dev/springdocsmcp/build/index.js"]
+    "spring-docs": {
+      "command": "springdocs-mcp"
     }
   }
 }

package/diagnostic.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+
+echo "🔍 Diagnostic du serveur MCP Spring Documentation"
+echo "================================================="
+echo
+
+echo "📦 Vérification de l'installation npm..."
+npm list -g @enokdev/springdocs-mcp 2>/dev/null || echo "❌ Package non installé globalement"
+echo
+
+echo "🔗 Vérification du lien symbolique..."
+if [ -L "/opt/homebrew/bin/springdocs-mcp" ]; then
+    echo "✅ Lien symbolique existe: $(readlink /opt/homebrew/bin/springdocs-mcp)"
+else
+    echo "❌ Lien symbolique manquant"
+fi
+echo
+
+echo "📂 Vérification du fichier executable..."
+if [ -x "/opt/homebrew/lib/node_modules/@enokdev/springdocs-mcp/build/index.js" ]; then
+    echo "✅ Fichier exécutable existe"
+else
+    echo "❌ Fichier exécutable manquant ou non exécutable"
+fi
+echo
+
+echo "🏗️ Vérification du shebang..."
+head -1 /opt/homebrew/lib/node_modules/@enokdev/springdocs-mcp/build/index.js | grep -q "#!/usr/bin/env node" && echo "✅ Shebang correct" || echo "❌ Shebang incorrect"
+echo
+
+echo "🔄 Test de la commande directe..."
+echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | timeout 5s /opt/homebrew/bin/springdocs-mcp 2>&1 | head -5 || echo "❌ Timeout ou erreur"
+echo
+
+echo "📋 Configuration Claude Desktop actuelle:"
+echo "$(cat ~/Library/Application\ Support/Claude/claude_desktop_config.json 2>/dev/null || echo '❌ Fichier de configuration non trouvé')"
+echo
+
+echo "💡 Configuration recommandée pour Claude Desktop:"
+cat << 'EOF'
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "/opt/homebrew/bin/springdocs-mcp"
+    }
+  }
+}
+EOF
+echo
+
+echo "🔧 Pour résoudre les problèmes potentiels:"
+echo "1. Redémarrer Claude Desktop complètement"
+echo "2. Vérifier que la configuration JSON est valide"
+echo "3. Utiliser le chemin absolu: /opt/homebrew/bin/springdocs-mcp"
+echo "4. Si nécessaire, réinstaller: npm uninstall -g @enokdev/springdocs-mcp && npm install -g @enokdev/springdocs-mcp"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enokdev/springdocs-mcp",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Public MCP server for accessing Spring Boot documentation and the complete Spring ecosystem",
   "type": "module",
   "main": "build/index.js",
@@ -22,7 +22,9 @@
     "watch": "tsc --watch",
     "prepublishOnly": "npm run build",
     "test": "node test.sh",
-    "install-global": "npm install -g ."
+    "install-global": "npm install -g .",
+    "setup-jetbrains": "./setup-jetbrains.sh",
+    "setup-all": "npm run setup-jetbrains"
   },
   "keywords": [
     "mcp",

package/setup-jetbrains.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+
+echo "🚀 Configuration automatique du serveur MCP Spring pour IDEs JetBrains"
+echo "======================================================================"
+echo
+
+# Couleurs pour l'affichage
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m' # No Color
+
+# Vérifier si springdocs-mcp est installé
+if ! command -v springdocs-mcp &> /dev/null; then
+    echo -e "${RED}❌ springdocs-mcp n'est pas installé globalement${NC}"
+    echo "Exécutez: npm install -g @enokdev/springdocs-mcp"
+    exit 1
+fi
+
+echo -e "${GREEN}✅ springdocs-mcp trouvé: $(which springdocs-mcp)${NC}"
+echo
+
+# Configuration MCP standard
+MCP_CONFIG='{
+  "spring-docs": {
+    "command": "/opt/homebrew/bin/springdocs-mcp",
+    "description": "Spring Documentation MCP Server - Access to complete Spring ecosystem",
+    "timeout": 30000
+  }
+}'
+
+# Fonction pour créer la configuration Claude générique
+create_claude_config() {
+    local config_dir="$1"
+    local config_file="$config_dir/claude_mcp_config.json"
+    
+    if [ ! -d "$config_dir" ]; then
+        mkdir -p "$config_dir"
+        echo -e "${BLUE}📁 Créé le dossier: $config_dir${NC}"
+    fi
+    
+    cat > "$config_file" << EOF
+{
+  "mcpServers": $MCP_CONFIG
+}
+EOF
+    
+    echo -e "${GREEN}✅ Configuration créée: $config_file${NC}"
+}
+
+# Fonction pour créer la configuration XML JetBrains
+create_jetbrains_xml() {
+    local ide_config_dir="$1"
+    local options_dir="$ide_config_dir/options"
+    local claude_xml="$options_dir/claude.xml"
+    
+    if [ ! -d "$options_dir" ]; then
+        mkdir -p "$options_dir"
+        echo -e "${BLUE}📁 Créé le dossier: $options_dir${NC}"
+    fi
+    
+    cat > "$claude_xml" << 'EOF'
+<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 MCP Server" />
+              <option name="timeout" value="30000" />
+            </MCPServerConfig>
+          </value>
+        </entry>
+      </map>
+    </option>
+  </component>
+</application>
+EOF
+    
+    echo -e "${GREEN}✅ Configuration XML créée: $claude_xml${NC}"
+}
+
+echo -e "${YELLOW}🔧 Configuration des IDEs JetBrains...${NC}"
+echo
+
+# Détecter le système d'exploitation
+if [[ "$OSTYPE" == "darwin"* ]]; then
+    # macOS
+    JETBRAINS_BASE="$HOME/Library/Application Support/JetBrains"
+    CONFIG_BASE="$HOME/.jetbrains"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+    # Linux
+    JETBRAINS_BASE="$HOME/.config/JetBrains"
+    CONFIG_BASE="$HOME/.jetbrains"
+elif [[ "$OSTYPE" == "msys" || "$OSTYPE" == "cygwin" ]]; then
+    # Windows
+    JETBRAINS_BASE="$APPDATA/JetBrains"
+    CONFIG_BASE="$HOME/.jetbrains"
+else
+    echo -e "${RED}❌ Système d'exploitation non supporté: $OSTYPE${NC}"
+    exit 1
+fi
+
+echo -e "${BLUE}📍 Dossier JetBrains détecté: $JETBRAINS_BASE${NC}"
+echo
+
+# Créer la configuration générique
+echo -e "${YELLOW}📝 Création de la configuration générique...${NC}"
+create_claude_config "$CONFIG_BASE"
+echo
+
+# Liste des IDEs JetBrains à configurer
+JETBRAINS_IDES=(
+    "IntelliJIdea"
+    "WebStorm"
+    "PyCharm"
+    "PhpStorm"
+    "RubyMine"
+    "CLion"
+    "GoLand"
+    "Rider"
+    "DataGrip"
+    "AndroidStudio"
+)
+
+echo -e "${YELLOW}🎯 Configuration des IDEs spécifiques...${NC}"
+
+for ide in "${JETBRAINS_IDES[@]}"; do
+    # Chercher les versions installées de l'IDE
+    if [ -d "$JETBRAINS_BASE" ]; then
+        ide_dirs=$(find "$JETBRAINS_BASE" -maxdepth 1 -type d -name "${ide}*" 2>/dev/null)
+        
+        if [ -n "$ide_dirs" ]; then
+            echo -e "${BLUE}🔍 Trouvé $ide:${NC}"
+            echo "$ide_dirs" | while read -r ide_dir; do
+                echo -e "  📁 $(basename "$ide_dir")"
+                create_jetbrains_xml "$ide_dir"
+            done
+        else
+            echo -e "${YELLOW}⚠️  $ide non installé ou non trouvé${NC}"
+        fi
+    fi
+done
+
+echo
+echo -e "${GREEN}🎉 Configuration terminée !${NC}"
+echo
+echo -e "${YELLOW}📋 Prochaines étapes:${NC}"
+echo "1. 🔄 Redémarrer vos IDEs JetBrains"
+echo "2. 🔌 Installer le plugin Claude (si pas déjà fait)"
+echo "3. ⚙️  Vérifier les paramètres Claude dans Settings → Tools → Claude"
+echo "4. 🧪 Tester avec une question Spring dans le chat Claude"
+echo
+echo -e "${BLUE}💡 Exemple de test:${NC}"
+echo "Demandez à Claude dans votre IDE: 'Quels sont les projets Spring pour la sécurité ?'"
+echo
+echo -e "${YELLOW}🔧 En cas de problème:${NC}"
+echo "- Vérifiez que springdocs-mcp fonctionne: echo '{\"jsonrpc\": \"2.0\", \"id\": 1, \"method\": \"tools/list\", \"params\": {}}' | springdocs-mcp"
+echo "- Consultez TROUBLESHOOTING.md pour plus d'aide"
+echo
+echo -e "${GREEN}✨ Votre serveur MCP Spring Documentation est maintenant disponible dans tous vos IDEs JetBrains !${NC}"

package/test-jetbrains.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+
+echo "🧪 Test des configurations JetBrains IDEs"
+echo "========================================="
+echo
+
+# Couleurs
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Fonction de test
+test_config_file() {
+    local file="$1"
+    local description="$2"
+    
+    if [ -f "$file" ]; then
+        echo -e "${GREEN}✅ $description${NC}"
+        echo -e "${BLUE}   📁 $file${NC}"
+        
+        # Vérifier si c'est un fichier JSON valide
+        if [[ "$file" == *.json ]]; then
+            if python3 -m json.tool "$file" > /dev/null 2>&1; then
+                echo -e "${GREEN}   ✅ JSON valide${NC}"
+            else
+                echo -e "${RED}   ❌ JSON invalide${NC}"
+            fi
+        fi
+        
+        # Vérifier si c'est un fichier XML valide
+        if [[ "$file" == *.xml ]]; then
+            if command -v xmllint &> /dev/null; then
+                if xmllint --noout "$file" 2>/dev/null; then
+                    echo -e "${GREEN}   ✅ XML valide${NC}"
+                else
+                    echo -e "${RED}   ❌ XML invalide${NC}"
+                fi
+            else
+                echo -e "${YELLOW}   ⚠️  xmllint non disponible (optionnel)${NC}"
+            fi
+        fi
+        echo
+    else
+        echo -e "${YELLOW}⚠️  $description - Non trouvé${NC}"
+        echo -e "${BLUE}   📁 $file${NC}"
+        echo
+    fi
+}
+
+echo -e "${YELLOW}🔍 Vérification des configurations créées...${NC}"
+echo
+
+# Configuration générique
+test_config_file "$HOME/.jetbrains/claude_mcp_config.json" "Configuration générique JetBrains"
+
+# IDEs spécifiques
+JETBRAINS_BASE="$HOME/Library/Application Support/JetBrains"
+
+if [ -d "$JETBRAINS_BASE" ]; then
+    echo -e "${BLUE}📍 Recherche des configurations IDE...${NC}"
+    echo
+    
+    # IntelliJ IDEA
+    find "$JETBRAINS_BASE" -name "IntelliJIdea*" -type d | while read -r ide_dir; do
+        claude_xml="$ide_dir/options/claude.xml"
+        test_config_file "$claude_xml" "IntelliJ IDEA $(basename "$ide_dir")"
+    done
+    
+    # WebStorm
+    find "$JETBRAINS_BASE" -name "WebStorm*" -type d | while read -r ide_dir; do
+        claude_xml="$ide_dir/options/claude.xml"
+        test_config_file "$claude_xml" "WebStorm $(basename "$ide_dir")"
+    done
+    
+    # GoLand
+    find "$JETBRAINS_BASE" -name "GoLand*" -type d | while read -r ide_dir; do
+        claude_xml="$ide_dir/options/claude.xml"
+        test_config_file "$claude_xml" "GoLand $(basename "$ide_dir")"
+    done
+    
+    # PyCharm
+    find "$JETBRAINS_BASE" -name "PyCharm*" -type d | while read -r ide_dir; do
+        claude_xml="$ide_dir/options/claude.xml"
+        test_config_file "$claude_xml" "PyCharm $(basename "$ide_dir")"
+    done
+    
+else
+    echo -e "${RED}❌ Dossier JetBrains non trouvé: $JETBRAINS_BASE${NC}"
+fi
+
+echo -e "${YELLOW}🧪 Test du serveur MCP...${NC}"
+echo
+
+# Test du serveur MCP
+if command -v springdocs-mcp &> /dev/null; then
+    echo -e "${GREEN}✅ Commande springdocs-mcp disponible${NC}"
+    
+    # Test rapide du serveur
+    echo -e "${BLUE}🔄 Test d'initialisation...${NC}"
+    echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' | timeout 5s springdocs-mcp > /dev/null 2>&1
+    
+    if [ $? -eq 0 ]; then
+        echo -e "${GREEN}✅ Serveur MCP répond correctement${NC}"
+    else
+        echo -e "${RED}❌ Problème avec le serveur MCP${NC}"
+    fi
+else
+    echo -e "${RED}❌ Commande springdocs-mcp non disponible${NC}"
+    echo "Exécutez: npm install -g @enokdev/springdocs-mcp"
+fi
+
+echo
+echo -e "${YELLOW}📋 Résumé des tests${NC}"
+echo -e "${GREEN}✅ = Configuration trouvée et valide${NC}"
+echo -e "${YELLOW}⚠️  = Configuration manquante (normal si IDE non installé)${NC}"
+echo -e "${RED}❌ = Problème détecté${NC}"
+echo
+echo -e "${BLUE}💡 Prochaines étapes:${NC}"
+echo "1. Redémarrer vos IDEs JetBrains"
+echo "2. Installer le plugin Claude dans chaque IDE"
+echo "3. Tester avec: 'Quels sont les projets Spring pour la sécurité ?'"
+echo
+echo -e "${GREEN}🎉 Configuration JetBrains terminée !${NC}"