fmea-api-mcp-server 1.0.6 → 1.0.7

package/README.md

@@ -101,7 +101,7 @@ When the package is published to NPM:
 - **Tools**:
 - **Tools**:
     - `search_apis`: 
-        - Smart search with relevance scoring (Summary > Description > Path).
-        - Supports filters: `query`, `method` (GET/POST), `version` (v1/v2).
-        - Results limited to top 10 by default to prevent context pollution.
+        - Smart search with relevance scoring and pagination.
+        - Supports filters: `query` (use `*` for all), `method`, `version`, `page` (default 1).
+        - Results limited to 10 per page. Returns meta info (total, totalPages) and guidance.
     - `get_api_details`: Get full details (schema, parameters) for a specific endpoint.

package/dist/index.js

@@ -114,6 +114,10 @@ class ApiDocsServer {
                                     type: "string",
                                     description: "Filter by API version (e.g. 'v1', 'v2'). Optional.",
                                 },
+                                page: {
+                                    type: "integer",
+                                    description: "Page number for pagination (default: 1).",
+                                },
                             },
                             required: ["query"],
                         },
@@ -144,7 +148,8 @@ class ApiDocsServer {
                 const query = String(request.params.arguments?.query).toLowerCase();
                 const method = request.params.arguments?.method ? String(request.params.arguments?.method).toUpperCase() : undefined;
                 const version = request.params.arguments?.version ? String(request.params.arguments?.version).toLowerCase() : undefined;
-                const results = await this.searchInFiles(query, method, version);
+                const page = request.params.arguments?.page ? Number(request.params.arguments?.page) : 1;
+                const results = await this.searchInFiles(query, method, version, page);
                 return {
                     content: [
                         {
@@ -205,19 +210,19 @@ class ApiDocsServer {
         }
         return results;
     }
-    // Smart search helper with scoring, filtering, and limits
-    async searchInFiles(query, filterMethod, filterVersion) {
+    // Smart search helper with scoring, filtering, limits, and pagination
+    async searchInFiles(query, filterMethod, filterVersion, page = 1) {
         const files = await this.getAllFiles(ENDPOINTS_DIR);
         let allMatches = [];
+        const isWildcard = query === "*" || query === "";
         for (const filePath of files) {
             try {
                 const content = await fs.readFile(filePath, "utf-8");
                 const json = JSON.parse(content);
                 const fileName = path.relative(ENDPOINTS_DIR, filePath);
-                // Version Filtering (File level or content level check)
-                // Check if file path contains version (e.g. "v1/...") or json has version field
+                // Version Filtering
                 if (filterVersion) {
-                    const fileVersion = fileName.split(path.sep)[0]; // e.g. "v1" from "v1/projects/..."
+                    const fileVersion = fileName.split(path.sep)[0];
                     if (fileVersion !== filterVersion && json.version !== filterVersion) {
                         continue;
                     }
@@ -230,17 +235,22 @@ class ApiDocsServer {
                         }
                         // Scoring Logic
                         let score = 0;
-                        const summary = (endpoint.summary || "").toLowerCase();
-                        const description = (endpoint.description || "").toLowerCase();
-                        const apiPath = (endpoint.path || "").toLowerCase();
-                        const operationId = (endpoint.operationId || "").toLowerCase();
-                        // 1. Exact/High relevance matches
-                        if (summary.includes(query) || operationId.includes(query))
-                            score += 10;
-                        if (description.includes(query))
-                            score += 5;
-                        if (apiPath.includes(query))
-                            score += 3;
+                        if (isWildcard) {
+                            score = 1; // All match in wildcard mode
+                        }
+                        else {
+                            const summary = (endpoint.summary || "").toLowerCase();
+                            const description = (endpoint.description || "").toLowerCase();
+                            const apiPath = (endpoint.path || "").toLowerCase();
+                            const operationId = (endpoint.operationId || "").toLowerCase();
+                            // Exact/High relevance matches
+                            if (summary.includes(query) || operationId.includes(query))
+                                score += 10;
+                            if (description.includes(query))
+                                score += 5;
+                            if (apiPath.includes(query))
+                                score += 3;
+                        }
                         if (score > 0) {
                             allMatches.push({
                                 score,
@@ -258,19 +268,40 @@ class ApiDocsServer {
                 // Ignore parse errors
             }
         }
-        // Sort by score descending
-        allMatches.sort((a, b) => b.score - a.score);
-        // Limit results
-        const LIMIT = 10;
         const totalFound = allMatches.length;
-        const limitedResults = allMatches.slice(0, LIMIT).map(({ score, ...rest }) => rest); // Remove score from output
-        if (totalFound > LIMIT) {
+        if (totalFound === 0) {
             return {
-                results: limitedResults,
-                warning: `Found ${totalFound} results. Showing top ${LIMIT}. Please refine your search query or use filters.`
+                results: [],
+                message: `No results found for '${query}'. Try using '*' to list all endpoints, or check your version/method filters.`
             };
         }
-        return limitedResults;
+        // Sort by score descending (only meaningful if not wildcard)
+        if (!isWildcard) {
+            allMatches.sort((a, b) => b.score - a.score);
+        }
+        // Pagination
+        const LIMIT = 10;
+        const totalPages = Math.ceil(totalFound / LIMIT);
+        const currentPage = Math.max(1, page); // Ensure page is at least 1
+        const start = (currentPage - 1) * LIMIT;
+        const end = start + LIMIT;
+        const slicedResults = allMatches.slice(start, end).map(({ score, ...rest }) => rest);
+        let warning = undefined;
+        if (totalPages > 1) {
+            warning = `Found ${totalFound} results. Showing page ${currentPage} of ${totalPages}.`;
+            if (currentPage < totalPages) {
+                warning += ` Use 'page: ${currentPage + 1}' to see next results.`;
+            }
+        }
+        return {
+            results: slicedResults,
+            meta: {
+                total: totalFound,
+                page: currentPage,
+                totalPages: totalPages
+            },
+            warning
+        };
     }
     // Helper to get full details of an API
     async getApiDetails(apiPath, method) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",