@enokdev/springdocs-mcp 1.1.1 → 1.2.1

package/README_FR.md

@@ -1,219 +0,0 @@
-# 📚 Spring Documentation MCP Server
-
-[![npm version](https://badge.fury.io/js/@enokdev%2Fspringdocs-mcp.svg)](https://badge.fury.io/js/@enokdev%2Fspringdocs-mcp)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/Node.js-18+-green.svg)](https://nodejs.org/)
-[![GitHub](https://img.shields.io/badge/GitHub-tky0065/springdocs--mcp-blue.svg)](https://github.com/tky0065/springdocs-mcp)
-
-A public **Model Context Protocol (MCP)** server that provides access to the complete Spring Boot documentation and Spring ecosystem directly in Claude Desktop.
-
-## 🚀 Quick Installation
-
-```bash
-npm install -g @enokdev/springdocs-mcp
-```
-
-Then add to your `claude_desktop_config.json`:
-```json
-{
-  "mcpServers": {
-    "spring-docs": {
-      "command": "springdocs-mcp"
-    }
-  }
-}
-```
-
-## ✨ Features
-
-- 🌐 **Complete access** to spring.io/projects (all Spring projects)
-- 📖 **Practical guides** spring.io/guides with filtering
-- 📚 **Reference documentation** docs.spring.io
-- � **Recherche intelligente** dans tout l'écosystème Spring
-- 💡 **Base de connaissances** intégrée des concepts Spring Boot
-- ⚡ **7 outils MCP** pour une exploration complète
-
-## 🛠️ Utilisation
-
-### Démarrage du serveur
-
-```bash
-npm start
-```
-
-ou
-
-```bash
-node build/index.js
-```
-
-## 🛠️ Outils disponibles
-
-Le serveur MCP propose **7 outils** pour explorer la documentation Spring :
-
-### 1. `search_spring_docs`
-Recherche dans la documentation Spring Boot avec des mots-clés.
-
-**Paramètres :**
-- `query` (string, requis) : Mots-clés à rechercher
-- `docType` (string, optionnel) : Type de documentation (`guides`, `reference`, `api`, `all`)
-- `limit` (number, optionnel) : Nombre maximum de résultats (défaut: 10)
-
-### 2. `search_spring_projects`
-Recherche parmi tous les projets Spring disponibles sur spring.io/projects.
-
-**Paramètres :**
-- `query` (string, requis) : Mots-clés à rechercher dans les projets Spring
-- `limit` (number, optionnel) : Nombre maximum de projets à retourner (défaut: 10)
-
-### 3. `get_spring_project`
-Récupère les détails complets d'un projet Spring spécifique.
-
-**Paramètres :**
-- `projectName` (string, requis) : Nom du projet Spring (ex: `spring-boot`, `spring-security`)
-
-### 4. `get_all_spring_guides`
-Récupère la liste de tous les guides Spring disponibles, optionnellement filtrés par catégorie.
-
-**Paramètres :**
-- `category` (string, optionnel) : Catégorie de guides à filtrer
-- `limit` (number, optionnel) : Nombre maximum de guides (défaut: 20)
-
-### 5. `get_spring_guide`
-Récupère le contenu complet d'un guide Spring Boot spécifique.
-
-**Paramètres :**
-- `guideId` (string, requis) : Identifiant du guide (ex: `gs-rest-service`)
-
-### 6. `get_spring_reference`
-Récupère une section spécifique de la documentation de référence Spring Boot.
-
-**Paramètres :**
-- `section` (string, requis) : Section de la documentation (ex: `web`, `data`, `security`)
-- `subsection` (string, optionnel) : Sous-section pour une recherche plus précise
-
-### 7. `search_spring_concepts`
-Recherche des concepts Spring Boot par catégorie avec explications détaillées.
-
-**Paramètres :**
-- `concept` (string, requis) : Concept à rechercher (ex: `auto-configuration`)
-- `category` (string, optionnel) : Catégorie (`core`, `web`, `data`, `security`, `testing`, `production`)
-
-## � Sources de documentation
-
-Ce serveur MCP accède aux sources de documentation Spring suivantes :
-
-- **🌟 [spring.io/projects](https://spring.io/projects)** - Tous les projets Spring (Boot, Security, Data, Cloud, etc.)
-- **📖 [spring.io/guides](https://spring.io/guides)** - Guides pratiques et tutoriels
-- **📚 [docs.spring.io](https://docs.spring.io)** - Documentation de référence officielle
-- **🔧 API Documentation** - Documentation des classes et méthodes
-- **💡 Base de connaissances intégrée** - Concepts et bonnes pratiques Spring Boot
-
-## �🔧 Configuration avec Claude Desktop
-
-Pour utiliser ce serveur avec Claude Desktop, ajoutez la configuration suivante dans votre fichier `claude_desktop_config.json` :
-
-```json
-{
-  "mcpServers": {
-    "springboot-docs": {
-      "command": "node",
-      "args": ["/chemin/absolu/vers/springdocsmcp/build/index.js"]
-    }
-  }
-}
-```
-
-### Localisation du fichier de configuration
-
-- **macOS** : `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows** : `%APPDATA%\\Claude\\claude_desktop_config.json`
-
-## 📚 Exemples d'utilisation
-
-### Recherche générale
-```
-Recherche "REST API" dans la documentation Spring Boot
-```
-
-### Recherche de projets Spring
-```
-Trouve des projets Spring liés à "security"
-```
-
-### Détails d'un projet spécifique
-```
-Montre-moi les détails du projet "spring-boot"
-```
-
-### Liste des guides par catégorie
-```
-Quels sont les guides Spring pour la catégorie "Web" ?
-```
-
-### Récupération d'un guide spécifique
-```
-Récupère le guide "gs-rest-service"
-```
-
-### Exploration des concepts
-```
-Explique le concept "auto-configuration" dans Spring Boot
-```
-
-## 🏗️ Architecture
-
-Le projet est organisé comme suit :
-
-```
-src/
-├── index.ts              # Point d'entrée principal
-├── services/
-│   └── springboot-docs.ts # Service de récupération de documentation
-└── tools/
-    └── index.ts          # Définitions des outils MCP
-```
-
-### Composants principaux
-
-- **SpringBootMCPServer** : Serveur MCP principal qui gère les requêtes
-- **SpringBootDocsService** : Service pour récupérer et traiter la documentation
-- **ToolDefinitions** : Définitions des outils exposés via MCP
-
-## 🔒 Sécurité
-
-- Le serveur accède uniquement aux ressources publiques de `docs.spring.io`
-- Aucune donnée sensible n'est stockée ou transmise
-- Toutes les requêtes HTTP sont en lecture seule
-
-## 🐛 Dépannage
-
-### Erreurs courantes
-
-1. **"Cannot find module"** : Vérifiez que `npm install` a été exécuté
-2. **"Serveur non démarré"** : Vérifiez que la compilation avec `npm run build` s'est bien passée
-3. **"Documentation non trouvée"** : Vérifiez votre connexion internet
-
-### Logs
-
-Le serveur écrit ses logs sur `stderr` pour éviter d'interférer avec le protocole MCP sur `stdout`.
-
-## 🤝 Contribution
-
-Les contributions sont les bienvenues ! N'hésitez pas à :
-
-1. Forker le projet
-2. Créer une branche pour votre fonctionnalité
-3. Commiter vos changements
-4. Pousser vers la branche
-5. Ouvrir une Pull Request
-
-## 📄 Licence
-
-Ce projet est sous licence MIT. Voir le fichier `LICENSE` pour plus de détails.
-
-## 🔗 Ressources utiles
-
-- [Documentation Spring Boot](https://docs.spring.io/spring-boot/docs/current/reference/html/)
-- [Model Context Protocol](https://modelcontextprotocol.io/)
-- [SDK MCP TypeScript](https://github.com/modelcontextprotocol/typescript-sdk)

package/RELEASE_NOTES_v1.1.0.md

@@ -1,106 +0,0 @@
-# 🎉 Spring Boot MCP Server v1.1.0 - Mise à jour majeure
-
-## 🚀 Améliorations apportées
-
-Votre serveur MCP Spring Boot Documentation a été considérablement amélioré ! Voici ce qui a été ajouté :
-
-### ✨ Nouvelles fonctionnalités principales
-
-#### 1. **Support complet de l'écosystème Spring**
-- ✅ Accès à **spring.io/projects** - Tous les projets Spring (Security, Data, Cloud, etc.)
-- ✅ Extension de **spring.io/guides** - Catalogue complet des guides
-- ✅ Intégration enrichie avec la documentation officielle
-
-#### 2. **3 nouveaux outils MCP** (Total : 7 outils)
-- 🆕 **`search_spring_projects`** - Recherche parmi tous les projets Spring
-- 🆕 **`get_spring_project`** - Détails complets d'un projet Spring
-- 🆕 **`get_all_spring_guides`** - Liste de tous les guides avec filtrage
-
-#### 3. **Base de connaissances étendue**
-- 📚 Projets Spring populaires intégrés (fallback robuste)
-- 🔍 Guides Spring organisés par catégories
-- 🎯 Recherche intelligente avec mécanismes de secours
-
-## 🛠️ Outils disponibles (7 au total)
-
-| Outil | Description | Nouveau |
-|-------|-------------|---------|
-| `search_spring_docs` | Recherche dans la documentation Spring Boot | ⭐ |
-| `search_spring_projects` | **Recherche de projets Spring** | 🆕 |
-| `get_spring_project` | **Détails d'un projet Spring** | 🆕 |
-| `get_all_spring_guides` | **Liste des guides Spring** | 🆕 |
-| `get_spring_guide` | Contenu d'un guide spécifique | ⭐ |
-| `get_spring_reference` | Documentation de référence | ⭐ |
-| `search_spring_concepts` | Recherche de concepts Spring Boot | ⭐ |
-
-## 📋 Tests rapides
-
-Testez les nouvelles fonctionnalités avec ces exemples :
-
-```bash
-# Test des nouveaux outils
-./test.sh
-
-# Ou individuellement :
-echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "search_spring_projects", "arguments": {"query": "security"}}}' | node build/index.js
-```
-
-## 🔧 Configuration Claude Desktop
-
-Votre configuration reste la même dans `claude_desktop_config.json` :
-
-```json
-{
-  "mcpServers": {
-    "springboot-docs": {
-      "command": "node",
-      "args": ["/Users/yacoubakone/Documents/dev/springdocsmcp/build/index.js"]
-    }
-  }
-}
-```
-
-## 📚 Documentation mise à jour
-
-- ✅ **README.md** - Documentation principale mise à jour
-- ✅ **EXAMPLES.md** - Guide d'exemples pratiques
-- ✅ **CONTRIBUTING.md** - Guide pour les développeurs
-- ✅ **CHANGELOG.md** - Historique des versions
-- ✅ **test.sh** - Script de test étendu
-
-## 🌟 Exemples d'utilisation avec Claude
-
-Maintenant vous pouvez demander à Claude :
-
-### Découverte de projets
-> "Quels sont les projets Spring disponibles pour la sécurité ?"
-
-### Exploration de l'écosystème
-> "Montre-moi tous les projets Spring liés aux données"
-
-### Guides spécialisés
-> "Quels sont les guides Spring Boot pour le développement web ?"
-
-### Détails de projets
-> "Peux-tu m'expliquer le projet Spring Cloud ?"
-
-## 🎯 Couverture documentaire
-
-Votre serveur MCP accède maintenant à :
-
-- 🌐 **Tous les projets Spring** (Boot, Security, Data, Cloud, Integration, etc.)
-- 📖 **Guides complets** avec filtrage par catégorie
-- 📚 **Documentation de référence** Spring Boot
-- 🔧 **API Documentation** 
-- 💡 **Base de connaissances** enrichie
-
-## ✅ État du projet
-
-- ✅ **Compilation réussie** (version 1.1.0)
-- ✅ **Tests passés** (7 outils fonctionnels)
-- ✅ **Documentation complète**
-- ✅ **Prêt pour la production**
-
----
-
-🎉 **Votre serveur MCP Spring Boot Documentation est maintenant un outil complet pour explorer tout l'écosystème Spring !**

package/claude_desktop_config.json

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

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
-```