@enokdev/springdocs-mcp 1.1.0

package/EXAMPLES.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

@@ -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/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Yacoub Akone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/PUBLICATION_ENOKDEV.md

@@ -0,0 +1,170 @@
+# 🚀 Guide de publication pour EnokDev (@enokdev)
+
+## 📋 Informations de publication
+
+- **GitHub**: https://github.com/tky0065
+- **npm**: https://www.npmjs.com/~enokdev
+- **Package**: `@enokdev/springdocs-mcp`
+- **Repository**: `tky0065/springdocs-mcp`
+
+## ⚡ Commandes de publication rapide
+
+### 1. Préparer le repository GitHub
+
+```bash
+# Dans votre dossier de projet
+cd /Users/yacoubakone/Documents/dev/springdocsmcp
+
+# Initialiser Git (si pas encore fait)
+git init
+git add .
+git commit -m "Initial release: Spring Documentation MCP Server v1.1.0"
+
+# Créer le repository sur GitHub avec le nom: springdocs-mcp
+# Description: "Spring Documentation MCP Server for Claude Desktop - Access the complete Spring ecosystem in Claude"
+
+# Connecter le repository local
+git remote add origin https://github.com/tky0065/springdocs-mcp.git
+git branch -M main
+git push -u origin main
+```
+
+### 2. Publication sur npm
+
+```bash
+# Se connecter à npm avec votre compte enokdev
+npm login
+# Username: enokdev
+# Password: [votre mot de passe]
+# Email: [votre email]
+
+# Vérifier la connexion
+npm whoami
+# Doit afficher: enokdev
+
+# Compilation et test final
+npm run build
+npm test
+
+# Publication
+npm publish --access public
+```
+
+### 3. Créer une release GitHub
+
+```bash
+# Créer un tag de version
+git tag v1.1.0
+git push origin v1.1.0
+
+# La GitHub Action va automatiquement créer une release
+```
+
+## 🌐 Après publication
+
+### Installation pour les utilisateurs
+
+```bash
+npm install -g @enokdev/springdocs-mcp
+```
+
+### Configuration Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"
+    }
+  }
+}
+```
+
+## 📈 Promotion
+
+### 1. Réseaux sociaux
+- **LinkedIn**: Post avec hashtags #SpringBoot #Claude #MCP #OpenSource
+- **Twitter/X**: Mention @springboot et @anthropicai
+- **GitHub**: Ajouter aux topics: `mcp`, `spring-boot`, `claude`, `documentation`
+
+### 2. Communautés
+- **Reddit**: r/SpringBoot, r/java, r/programming
+- **Dev.to**: Article de présentation
+- **Stack Overflow**: Répondre aux questions Spring Boot avec votre outil
+
+### 3. Documentation officielle
+- **MCP Registry**: Soumettre à la liste officielle MCP
+- **Awesome Lists**: Ajouter aux listes "Awesome MCP" sur GitHub
+
+## 🔗 Liens utiles
+
+- **Package npm**: https://www.npmjs.com/package/@enokdev/springdocs-mcp
+- **Repository GitHub**: https://github.com/tky0065/springdocs-mcp
+- **Documentation**: https://tky0065.github.io/springdocs-mcp
+- **Issues**: https://github.com/tky0065/springdocs-mcp/issues
+
+## 📊 Métriques à suivre
+
+- Downloads npm: https://npm-stat.com/charts.html?package=@enokdev/springdocs-mcp
+- GitHub stars et forks
+- Issues et pull requests
+- Feedback utilisateurs
+
+## 🔄 Mises à jour futures
+
+```bash
+# Pour publier une mise à jour
+npm version patch  # ou minor/major
+git add .
+git commit -m "Release v$(node -p "require('./package.json').version")"
+git tag "v$(node -p "require('./package.json').version")"
+git push origin main --tags
+npm publish
+```
+
+## 🎯 Script de publication automatique
+
+```bash
+#!/bin/bash
+# publish.sh
+
+set -e
+
+echo "🔍 Vérifications pré-publication..."
+npm run build
+npm test
+
+echo "📝 Mise à jour de version..."
+npm version patch
+
+echo "📤 Envoi vers GitHub..."
+git push origin main --tags
+
+echo "📦 Publication sur npm..."
+npm publish --access public
+
+echo "✅ Publication terminée!"
+echo "Package: https://www.npmjs.com/package/@enokdev/springdocs-mcp"
+echo "GitHub: https://github.com/tky0065/springdocs-mcp"
+```
+
+---
+
+## 🎉 Message de lancement suggéré
+
+```markdown
+🚀 Nouveau package npm: @enokdev/springdocs-mcp
+
+Un serveur MCP qui donne accès à TOUTE la documentation Spring (Boot, Security, Data, Cloud...) directement dans Claude Desktop !
+
+✨ 7 outils MCP pour explorer l'écosystème Spring
+📚 Accès instantané à spring.io/projects + guides + docs
+🔍 Recherche intelligente dans toute la documentation
+⚡ Installation en une commande: npm install -g @enokdev/springdocs-mcp
+
+Perfect pour tous les développeurs Spring utilisant Claude ! 
+
+#SpringBoot #Claude #MCP #OpenSource #Documentation
+```
+
+**🌟 Votre serveur MCP sera bientôt disponible pour toute la communauté des développeurs Spring !**

package/PUBLISHING.md

@@ -0,0 +1,196 @@
+# 📦 Guide de publication - Spring Documentation MCP Server
+
+Ce guide explique comment publier le serveur MCP pour que tout le monde puisse l'utiliser.
+
+## 🚀 Étapes de publication
+
+### 1. Préparation du repository GitHub
+
+```bash
+# Initialiser Git (si pas déjà fait)
+git init
+git add .
+git commit -m "Initial commit: Spring Documentation MCP Server v1.1.0"
+
+# Créer un repository sur GitHub
+# Puis connecter le repository local
+git remote add origin https://github.com/tky0065/springdocs-mcp.git
+git branch -M main
+git push -u origin main
+```
+
+### 2. Publication sur npm
+
+#### A. Créer un compte npm
+```bash
+npm adduser
+# ou
+npm login
+```
+
+#### B. Vérifier la configuration
+```bash
+npm whoami
+npm config list
+```
+
+#### C. Test avant publication
+```bash
+npm run build
+npm pack --dry-run
+```
+
+#### D. Publication
+```bash
+# Publication initiale
+npm publish --access public
+
+# Ou pour une mise à jour
+npm version patch  # ou minor/major
+npm publish
+```
+
+### 3. Création d'un registry MCP public
+
+#### A. Créer un fichier de registry
+```json
+{
+  "name": "@enokdev/springdocs-mcp",
+  "description": "Spring Documentation MCP Server for Claude Desktop",
+  "version": "1.1.0",
+  "homepage": "https://github.com/tky0065/springdocs-mcp",
+  "repository": "https://github.com/tky0065/springdocs-mcp.git",
+  "author": "EnokDev",
+  "license": "MIT",
+  "keywords": ["mcp", "spring", "documentation", "claude"],
+  "installation": {
+    "npm": "@enokdev/springdocs-mcp",
+    "github": "tky0065/springdocs-mcp"
+  },
+  "usage": {
+    "command": "springdocs-mcp",
+    "config": {
+      "mcpServers": {
+        "spring-docs": {
+          "command": "springdocs-mcp"
+        }
+      }
+    }
+  }
+}
+```
+
+## 🌐 Distribution publique
+
+### 1. Via npm (recommandé)
+Les utilisateurs peuvent installer avec :
+```bash
+npm install -g @enokdev/springdocs-mcp
+```
+
+### 2. Via GitHub Releases
+```bash
+# Créer un tag de version
+git tag v1.1.0
+git push origin v1.1.0
+
+# Créer une release sur GitHub avec les binaires
+```
+
+### 3. Via Docker (optionnel)
+```dockerfile
+FROM node:18-alpine
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --only=production
+COPY build/ ./build/
+EXPOSE 3000
+CMD ["node", "build/index.js"]
+```
+
+## 📋 Liste de vérification avant publication
+
+- [ ] ✅ **Code testé** - Tous les outils fonctionnent
+- [ ] ✅ **Documentation complète** - README, INSTALL, EXAMPLES
+- [ ] ✅ **Version mise à jour** - package.json et code source
+- [ ] ✅ **License ajoutée** - MIT License
+- [ ] ✅ **Repository GitHub** - Code source accessible
+- [ ] ✅ **npm configuré** - Accès de publication
+- [ ] ✅ **Keywords optimisés** - Pour la découverte
+- [ ] ✅ **Tests passés** - Script de test fonctionne
+
+## 🔧 Configuration pour les utilisateurs
+
+### Configuration Claude Desktop simplifiée
+```json
+{
+  "mcpServers": {
+    "spring-docs": {
+      "command": "springdocs-mcp"
+    }
+  }
+}
+```
+
+### Documentation utilisateur
+Créer des guides pour :
+- Installation rapide
+- Configuration Claude Desktop
+- Exemples d'utilisation
+- Dépannage
+
+## 📈 Promotion et visibilité
+
+### 1. Soumission aux annuaires MCP
+- Registre officiel MCP (si disponible)
+- Awesome MCP lists sur GitHub
+- Documentation Anthropic
+
+### 2. Communication
+- Article de blog
+- Post LinkedIn/Twitter
+- Documentation Spring Boot community
+- Slack/Discord Spring Boot
+
+### 3. SEO et découvrabilité
+- Keywords optimisés dans package.json
+- README avec badges
+- Documentation claire
+- Exemples concrets
+
+## 🔄 Maintenance continue
+
+### 1. Versioning sémantique
+- **PATCH** : Corrections de bugs
+- **MINOR** : Nouvelles fonctionnalités
+- **MAJOR** : Changements incompatibles
+
+### 2. Monitoring
+- GitHub issues
+- npm downloads
+- Feedback utilisateurs
+
+### 3. Mises à jour
+- Dépendances sécurisées
+- Nouvelles fonctionnalités Spring
+- Améliorations MCP
+
+---
+
+## 🎯 Commandes de publication rapide
+
+```bash
+# Préparation
+npm run build
+npm test
+
+# Publication
+npm version minor
+git add .
+git commit -m "Release v$(node -p "require('./package.json').version")"
+git tag "v$(node -p "require('./package.json').version")"
+git push origin main --tags
+npm publish --access public
+```
+
+🌟 **Votre serveur MCP sera alors accessible à tous les utilisateurs de Claude Desktop !**