@enokdev/springdocs-mcp 1.2.0 → 1.2.1

package/src/tools/index.ts

@@ -1,144 +0,0 @@
-/**
- * Définitions des outils MCP pour l'accès à la documentation Spring Boot
- */
-
-export class ToolDefinitions {
-  static getToolList() {
-    return [
-      {
-        name: "search_spring_docs",
-        description: "Recherche dans la documentation Spring Boot avec des mots-clés",
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: {
-              type: "string",
-              description: "Les mots-clés à rechercher dans la documentation",
-            },
-            docType: {
-              type: "string",
-              enum: ["guides", "reference", "api", "all"],
-              description: "Type de documentation à rechercher",
-              default: "all",
-            },
-            limit: {
-              type: "number",
-              description: "Nombre maximum de résultats à retourner",
-              default: 10,
-              minimum: 1,
-              maximum: 50,
-            },
-          },
-          required: ["query"],
-        },
-      },
-      {
-        name: "search_spring_projects",
-        description: "Recherche parmi tous les projets Spring disponibles sur spring.io/projects",
-        inputSchema: {
-          type: "object",
-          properties: {
-            query: {
-              type: "string",
-              description: "Les mots-clés à rechercher dans les projets Spring (ex: 'security', 'data', 'cloud')",
-            },
-            limit: {
-              type: "number",
-              description: "Nombre maximum de projets à retourner",
-              default: 10,
-              minimum: 1,
-              maximum: 20,
-            },
-          },
-          required: ["query"],
-        },
-      },
-      {
-        name: "get_spring_project",
-        description: "Récupère les détails complets d'un projet Spring spécifique",
-        inputSchema: {
-          type: "object",
-          properties: {
-            projectName: {
-              type: "string",
-              description: "Le nom du projet Spring (ex: 'spring-boot', 'spring-security', 'spring-data')",
-            },
-          },
-          required: ["projectName"],
-        },
-      },
-      {
-        name: "get_all_spring_guides",
-        description: "Récupère la liste de tous les guides Spring disponibles, optionnellement filtrés par catégorie",
-        inputSchema: {
-          type: "object",
-          properties: {
-            category: {
-              type: "string",
-              description: "Catégorie de guides à filtrer (ex: 'Web', 'Data', 'Security', 'Testing')",
-            },
-            limit: {
-              type: "number",
-              description: "Nombre maximum de guides à retourner",
-              default: 20,
-              minimum: 1,
-              maximum: 50,
-            },
-          },
-          required: [],
-        },
-      },
-      {
-        name: "get_spring_guide",
-        description: "Récupère le contenu complet d'un guide Spring Boot spécifique",
-        inputSchema: {
-          type: "object",
-          properties: {
-            guideId: {
-              type: "string",
-              description: "L'identifiant du guide Spring Boot (par exemple: 'gs-rest-service', 'gs-accessing-data-jpa')",
-            },
-          },
-          required: ["guideId"],
-        },
-      },
-      {
-        name: "get_spring_reference",
-        description: "Récupère une section spécifique de la documentation de référence Spring Boot",
-        inputSchema: {
-          type: "object",
-          properties: {
-            section: {
-              type: "string",
-              description: "La section de la documentation de référence (par exemple: 'web', 'data', 'security')",
-            },
-            subsection: {
-              type: "string",
-              description: "Sous-section optionnelle pour une recherche plus précise",
-            },
-          },
-          required: ["section"],
-        },
-      },
-      {
-        name: "search_spring_concepts",
-        description: "Recherche des concepts Spring Boot par catégorie avec des explications détaillées",
-        inputSchema: {
-          type: "object",
-          properties: {
-            concept: {
-              type: "string",
-              description: "Le concept Spring Boot à rechercher (par exemple: 'auto-configuration', 'profiles', 'actuator')",
-            },
-            category: {
-              type: "string",
-              enum: ["core", "web", "data", "security", "testing", "production"],
-              description: "Catégorie du concept pour filtrer les résultats",
-            },
-          },
-          required: ["concept"],
-        },
-      },
-    ];
-  }
-}

package/test-jetbrains.sh

@@ -1,125 +0,0 @@
-#!/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}"

package/test.sh

@@ -1,64 +0,0 @@
-#!/bin/bash
-
-# Script de test pour le serveur MCP Spring Boot Documentation
-# Ce script teste les différentes fonctionnalités du serveur
-
-echo "🧪 Test du serveur MCP Spring Boot Documentation"
-echo "================================================"
-
-# Fonction pour envoyer une requête JSON-RPC et afficher la réponse
-send_request() {
-    local request="$1"
-    local description="$2"
-    
-    echo -e "\n📝 Test: $description"
-    echo "Requête: $request"
-    echo "Réponse:"
-    echo "$request" | node build/index.js | tail -n 1 | jq '.'
-    echo "---"
-}
-
-# Vérifier que le serveur est compilé
-if [ ! -f "build/index.js" ]; then
-    echo "❌ Le serveur n'est pas compilé. Exécutez 'npm run build' d'abord."
-    exit 1
-fi
-
-# Vérifier que jq est installé pour formater le JSON
-if ! command -v jq &> /dev/null; then
-    echo "⚠️  jq n'est pas installé. Les réponses JSON ne seront pas formatées."
-    alias jq="cat"
-fi
-
-# Test 1: Initialisation
-send_request '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2025-06-18", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0.0"}}}' "Initialisation du serveur"
-
-# Test 2: Liste des outils
-send_request '{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}' "Liste des outils disponibles"
-
-# Test 3: Recherche de documentation
-send_request '{"jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": {"name": "search_spring_docs", "arguments": {"query": "REST API", "limit": 3}}}' "Recherche de documentation REST API"
-
-# Test 4: Recherche de projets Spring
-send_request '{"jsonrpc": "2.0", "id": 4, "method": "tools/call", "params": {"name": "search_spring_projects", "arguments": {"query": "security", "limit": 3}}}' "Recherche de projets Spring Security"
-
-# Test 5: Détails d'un projet Spring
-send_request '{"jsonrpc": "2.0", "id": 5, "method": "tools/call", "params": {"name": "get_spring_project", "arguments": {"projectName": "spring-boot"}}}' "Détails du projet Spring Boot"
-
-# Test 6: Liste des guides Spring
-send_request '{"jsonrpc": "2.0", "id": 6, "method": "tools/call", "params": {"name": "get_all_spring_guides", "arguments": {"category": "Web", "limit": 5}}}' "Guides Spring catégorie Web"
-
-# Test 7: Recherche de concepts
-send_request '{"jsonrpc": "2.0", "id": 7, "method": "tools/call", "params": {"name": "search_spring_concepts", "arguments": {"concept": "auto-configuration"}}}' "Recherche du concept auto-configuration"
-
-echo -e "\n✅ Tests terminés!"
-echo ""
-echo "Pour utiliser ce serveur avec Claude Desktop, ajoutez ceci à votre claude_desktop_config.json:"
-echo '{'
-echo '  "mcpServers": {'
-echo '    "springboot-docs": {'
-echo '      "command": "node",'
-echo "      \"args\": [\"$(pwd)/build/index.js\"]"
-echo '    }'
-echo '  }'
-echo '}'

package/tsconfig.json

@@ -1,24 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "outDir": "./build",
-    "rootDir": "./src",
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "declaration": true,
-    "declarationMap": true,
-    "sourceMap": true
-  },
-  "include": [
-    "src/**/*"
-  ],
-  "exclude": [
-    "node_modules",
-    "build"
-  ]
-}