@enokdev/springdocs-mcp 1.1.0

package/src/tools/index.ts

@@ -0,0 +1,144 @@
+/**
+ * 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.sh

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

@@ -0,0 +1,24 @@
+{
+  "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"
+  ]
+}