@enokdev/springdocs-mcp 1.2.0 → 1.2.2

package/RELEASE_NOTES_v1.2.0.md

@@ -1,138 +0,0 @@
-# 🚀 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

@@ -1,163 +0,0 @@
-# 🔧 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,7 +0,0 @@
-{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "springdocs-mcp"
-    }
-  }
-}

package/diagnostic.sh

@@ -1,55 +0,0 @@
-#!/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/docs/index.html

@@ -1,147 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>Spring Documentation MCP Server</title>
-    <style>
-        * { margin: 0; padding: 0; box-sizing: border-box; }
-        body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; line-height: 1.6; color: #333; }
-        .container { max-width: 1200px; margin: 0 auto; padding: 0 20px; }
-        header { background: linear-gradient(135deg, #6fa8dc, #4285f4); color: white; padding: 60px 0; text-align: center; }
-        h1 { font-size: 3rem; margin-bottom: 20px; }
-        .subtitle { font-size: 1.5rem; opacity: 0.9; }
-        .hero { padding: 80px 0; text-align: center; background: #f8f9fa; }
-        .feature-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(300px, 1fr)); gap: 30px; margin: 60px 0; }
-        .feature { background: white; padding: 30px; border-radius: 8px; box-shadow: 0 2px 10px rgba(0,0,0,0.1); }
-        .feature h3 { color: #4285f4; margin-bottom: 15px; }
-        .install-section { background: #2d3748; color: white; padding: 60px 0; }
-        .code-block { background: #1a202c; padding: 20px; border-radius: 8px; margin: 20px 0; overflow-x: auto; }
-        .code-block code { color: #68d391; font-family: 'Monaco', 'Consolas', monospace; }
-        .tools-section { padding: 60px 0; }
-        .tool { border-left: 4px solid #4285f4; padding: 20px; margin: 20px 0; background: #f8f9fa; }
-        footer { background: #2d3748; color: white; padding: 40px 0; text-align: center; }
-        .btn { display: inline-block; background: #4285f4; color: white; padding: 12px 24px; text-decoration: none; border-radius: 6px; margin: 10px; }
-        .btn:hover { background: #3367d6; }
-    </style>
-</head>
-<body>
-    <header>
-        <div class="container">
-            <h1>🌱 Spring Documentation MCP Server</h1>
-            <p class="subtitle">Access the complete Spring ecosystem directly in Claude Desktop</p>
-        </div>
-    </header>
-
-    <section class="hero">
-        <div class="container">
-            <h2>The Complete Spring Documentation at Your Fingertips</h2>
-            <p>A public Model Context Protocol server that provides instant access to Spring Boot documentation, guides, and the entire Spring ecosystem.</p>
-            <a href="#install" class="btn">Get Started</a>
-            <a href="https://github.com/tky0065/springdocs-mcp" class="btn">View on GitHub</a>
-        </div>
-    </section>
-
-    <section class="container">
-        <div class="feature-grid">
-            <div class="feature">
-                <h3>🌐 Complete Spring Ecosystem</h3>
-                <p>Access all Spring projects: Boot, Security, Data, Cloud, and more. Get detailed project information and documentation.</p>
-            </div>
-            <div class="feature">
-                <h3>📚 Comprehensive Guides</h3>
-                <p>Browse and access hundreds of Spring guides organized by category. Perfect for learning and reference.</p>
-            </div>
-            <div class="feature">
-                <h3>🔍 Intelligent Search</h3>
-                <p>Search across documentation, concepts, and guides with intelligent fallback mechanisms.</p>
-            </div>
-            <div class="feature">
-                <h3>⚡ 7 Powerful Tools</h3>
-                <p>Seven specialized MCP tools for exploring every aspect of Spring development.</p>
-            </div>
-            <div class="feature">
-                <h3>🔧 Easy Integration</h3>
-                <p>Simple one-command installation and configuration with Claude Desktop.</p>
-            </div>
-            <div class="feature">
-                <h3>💡 Built-in Knowledge</h3>
-                <p>Integrated knowledge base of Spring Boot concepts and best practices.</p>
-            </div>
-        </div>
-    </section>
-
-    <section class="install-section" id="install">
-        <div class="container">
-            <h2>Quick Installation</h2>
-            <div class="code-block">
-                <code>npm install -g @enokdev/springdocs-mcp</code>
-            </div>
-            <p>Then add to your Claude Desktop configuration:</p>
-            <div class="code-block">
-                <code>{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "springdocs-mcp"
-    }
-  }
-}</code>
-            </div>
-        </div>
-    </section>
-
-    <section class="tools-section">
-        <div class="container">
-            <h2>Available Tools</h2>
-            <div class="tool">
-                <h3>search_spring_docs</h3>
-                <p>Search through Spring Boot documentation with keywords and filters.</p>
-            </div>
-            <div class="tool">
-                <h3>search_spring_projects</h3>
-                <p>Find Spring projects by category or functionality (Security, Data, Cloud, etc.)</p>
-            </div>
-            <div class="tool">
-                <h3>get_spring_project</h3>
-                <p>Get detailed information about a specific Spring project.</p>
-            </div>
-            <div class="tool">
-                <h3>get_all_spring_guides</h3>
-                <p>Browse all available Spring guides with optional category filtering.</p>
-            </div>
-            <div class="tool">
-                <h3>get_spring_guide</h3>
-                <p>Retrieve the complete content of a specific Spring guide.</p>
-            </div>
-            <div class="tool">
-                <h3>get_spring_reference</h3>
-                <p>Access specific sections of the Spring Boot reference documentation.</p>
-            </div>
-            <div class="tool">
-                <h3>search_spring_concepts</h3>
-                <p>Explore Spring Boot concepts with detailed explanations and examples.</p>
-            </div>
-        </div>
-    </section>
-
-    <section class="hero">
-        <div class="container">
-            <h2>Example Usage</h2>
-            <p>Once installed, ask Claude:</p>
-            <ul style="text-align: left; display: inline-block; margin-top: 20px;">
-                <li><em>"What Spring projects are available for security?"</em></li>
-                <li><em>"Show me the guide for creating a REST API with Spring Boot"</em></li>
-                <li><em>"How do I configure Spring Security?"</em></li>
-                <li><em>"Explain Spring Boot auto-configuration"</em></li>
-            </ul>
-        </div>
-    </section>
-
-    <footer>
-        <div class="container">
-            <p>&copy; 2025 Spring Documentation MCP Server by <a href="https://github.com/tky0065" style="color: #68d391;">EnokDev</a> | MIT License</p>
-            <p>Access the complete Spring ecosystem directly in Claude Desktop</p>
-        </div>
-    </footer>
-</body>
-</html>

package/guid.md

@@ -1,92 +0,0 @@
-   # 🚀 Serveur MCP Spring Boot Documentation
-
-## En TypeScript  
-https://github.com/modelcontextprotocol/typescript-sdk
-
-## 📖 Vue d'ensemble
-
-Ce projet implémente un serveur MCP (Model Context Protocol) en **TypeScript** qui permet d'accéder facilement à la documentation officielle de Spring Boot. Le serveur récupère et formate le contenu depuis `docs.spring.io` et l'expose via une interface MCP standardisée.
-
-Utilise aussi https://spring.io/projects
-
-### 🎯 Objectifs
-
-- ✅ Fournir un accès programmatique à la documentation Spring Boot
-- ✅ Supporter le protocole MCP 2025-06-18
-- ✅ Convertir le HTML en format Markdown lisible
-- ✅ Offrir une interface simple et bien documentée
-
-Ce serveur MCP (Model Context Protocol) permet d'accéder à la documentation officielle de Spring Boot via une interface standardisée, **maintenant disponible pour un usage public** comme Context7 !
-
-## 🛠️ Fonctionnalités
-
-### Outils disponibles
-
-1. **`search_spring_docs`** - Recherche dans la documentation avec des mots-clés
-2. **`get_spring_guide`** - Récupère un guide Spring Boot complet  
-3. **`get_spring_reference`** - Accède aux sections de la documentation de référence
-4. **`search_spring_concepts`** - Recherche des concepts par catégorie
-
-### Catégories de concepts supportées
-
-- **Core** : Auto-configuration, Profiles, Properties
-- **Web** : Spring MVC, Serveurs intégrés
-- **Data** : Spring Data JPA, Migration de base de données
-- **Security** : Spring Security
-- **Testing** : Test Slices, annotations de test
-- **Production** : Actuator, monitoring
-
-## 🚀 Installation et utilisation
-
-### 1. Installation des dépendances
-```bash
-npm install
-```
-
-### 2. Compilation
-```bash
-npm run build
-```
-
-### 3. Test du serveur
-```bash
-npm start
-```
-
-### 4. Configuration avec Claude Desktop
-
-Copiez la configuration suivante dans votre fichier `claude_desktop_config.json` :
-
-**macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
-**Windows** : `%APPDATA%\Claude\claude_desktop_config.json`
-
-```json
-{
-  "mcpServers": {
-    "springboot-docs": {
-      "command": "node",
-      "args": ["/Users/yacoubakone/Documents/dev/springdocsmcp/build/index.js"]
-    }
-  }
-}
-```
-
-## 📝 Exemples d'utilisation
-
-Une fois configuré avec Claude Desktop, vous pouvez utiliser des requêtes comme :
-
-- "Recherche dans la documentation Spring Boot sur les API REST"
-- "Récupère le guide gs-rest-service"
-- "Explique le concept d'auto-configuration dans Spring Boot"
-- "Montre-moi la documentation sur Spring Security"
-
-## 🏗️ Architecture du projet
-
-```
-src/
-├── index.ts                 # Point d'entrée principal du serveur MCP
-├── services/
-│   └── springboot-docs.ts   # Service de récupération de documentation
-└── tools/
-    └── index.ts            # Définitions des outils MCP exposés
-```