fmea-api-mcp-server 1.0.5 → 1.0.6

package/README.md

@@ -99,5 +99,9 @@ When the package is published to NPM:
 ## Features
 - **Resources**: Can read JSON files in the `endpoints` folder.
 - **Tools**:
-    - `search_apis`: Search APIs by keyword (returns summaries).
+- **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.
     - `get_api_details`: Get full details (schema, parameters) for a specific endpoint.

package/dist/index.js

@@ -104,7 +104,15 @@ class ApiDocsServer {
                             properties: {
                                 query: {
                                     type: "string",
-                                    description: "Search query (e.g. 'user login', 'POST /api/v1')",
+                                    description: "Search query (e.g. 'user login', 'create project').",
+                                },
+                                method: {
+                                    type: "string",
+                                    description: "Filter by HTTP method (e.g. 'GET', 'POST'). Optional.",
+                                },
+                                version: {
+                                    type: "string",
+                                    description: "Filter by API version (e.g. 'v1', 'v2'). Optional.",
                                 },
                             },
                             required: ["query"],
@@ -134,7 +142,9 @@ class ApiDocsServer {
         this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
             if (request.params.name === "search_apis") {
                 const query = String(request.params.arguments?.query).toLowerCase();
-                const results = await this.searchInFiles(query);
+                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);
                 return {
                     content: [
                         {
@@ -195,20 +205,45 @@ class ApiDocsServer {
         }
         return results;
     }
-    // Simple search helper - returns summaries
-    async searchInFiles(query) {
+    // Smart search helper with scoring, filtering, and limits
+    async searchInFiles(query, filterMethod, filterVersion) {
         const files = await this.getAllFiles(ENDPOINTS_DIR);
-        const matches = [];
+        let allMatches = [];
         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
+                if (filterVersion) {
+                    const fileVersion = fileName.split(path.sep)[0]; // e.g. "v1" from "v1/projects/..."
+                    if (fileVersion !== filterVersion && json.version !== filterVersion) {
+                        continue;
+                    }
+                }
                 if (json.endpoints && Array.isArray(json.endpoints)) {
                     for (const endpoint of json.endpoints) {
-                        const str = JSON.stringify(endpoint).toLowerCase();
-                        if (str.includes(query)) {
-                            matches.push({
+                        // Method Filtering
+                        if (filterMethod && endpoint.method.toUpperCase() !== filterMethod) {
+                            continue;
+                        }
+                        // 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 (score > 0) {
+                            allMatches.push({
+                                score,
                                 file: fileName,
                                 method: endpoint.method,
                                 path: endpoint.path,
@@ -223,7 +258,19 @@ class ApiDocsServer {
                 // Ignore parse errors
             }
         }
-        return matches;
+        // 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) {
+            return {
+                results: limitedResults,
+                warning: `Found ${totalFound} results. Showing top ${LIMIT}. Please refine your search query or use filters.`
+            };
+        }
+        return limitedResults;
     }
     // 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.5",
+  "version": "1.0.6",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",