fmea-api-mcp-server 1.1.28 → 1.1.30

package/dist/index.js

@@ -28,7 +28,7 @@ class ApiDocsServer {
     constructor() {
         this.server = new Server({
             name: "api-docs-mcp",
-            version: "1.1.28",
+            version: "1.1.30",
         }, {
             capabilities: {
                 resources: {},

package/dist/services/search/OramaSearchService.js

@@ -1,5 +1,4 @@
 import { create, load, search } from '@orama/orama';
-import { pipeline } from '@xenova/transformers';
 import fs from 'fs/promises';
 import path from 'path';
 import { paginateResults, DEFAULT_PAGE_SIZE } from '../../utils/search-helper.js';
@@ -51,9 +50,16 @@ export class OramaSearchService {
             catch (lookupError) {
                 console.error('⚠️ OramaSearchService: endpoint-lookup.json not found, falling back to index-only mode.');
             }
-            // Initialize model lazily or here. Here is better to fail fast.
-            this.extractor = await pipeline('feature-extraction', 'Xenova/bge-small-en-v1.5');
-            console.error('✅ OramaSearchService: Index loaded and model ready.');
+            // Initialize embedding model (fastembed / onnxruntime-node)
+            try {
+                const { FlagEmbedding, EmbeddingModel } = await import('fastembed');
+                this.extractor = await FlagEmbedding.init({ model: EmbeddingModel.BGESmallENV15 });
+                console.error('✅ OramaSearchService: Index loaded and model ready (hybrid mode).');
+            }
+            catch (embeddingError) {
+                console.error('⚠️ OramaSearchService: Embedding model unavailable, using BM25 text search only.', embeddingError);
+                this.extractor = null;
+            }
         }
         catch (error) {
             console.error('❌ OramaSearchService initialization failed:', error);
@@ -61,7 +67,7 @@ export class OramaSearchService {
     }
     async search(query, filterMethod, filterVersion, page = 1, explicitPath) {
         await this.initPromise; // Ensure service is ready
-        if (!this.db || !this.extractor) {
+        if (!this.db) {
             return { results: [], meta: { total: 0, page, totalPages: 0 }, warning: 'Search service not initialized' };
         }
         if (!query || query.trim() === '') {
@@ -139,33 +145,50 @@ export class OramaSearchService {
                 expandedQuery += ' ' + extraSynonyms.join(' ');
             }
             console.error(`[Orama] Expanded Query: "${expandedQuery}"`);
-            const output = await this.extractor(safeQuery, { pooling: 'mean', normalize: true });
-            const embedding = Array.from(output.data);
             // 3. Build Where Clauses
             const where = {};
             if (filterMethod)
                 where.method = filterMethod;
             if (filterVersion)
                 where.version = filterVersion;
-            // 4. Search — description-centric with path support
-            const searchResult = await search(this.db, {
-                term: expandedQuery,
-                tolerance: 2,
-                properties: ['description', 'path'],
-                boost: {
-                    description: 5.0,
-                    path: 10.0
-                },
-                vector: {
-                    value: embedding,
-                    property: 'embedding'
-                },
-                mode: 'hybrid',
-                similarity: 0,
-                where,
-                limit: 1000,
-                offset: 0
-            });
+            // 4. Search — hybrid (BM25 + vector) when embedding available, BM25-only otherwise
+            let searchResult;
+            if (this.extractor) {
+                const embedding = await this.extractor.queryEmbed(safeQuery);
+                searchResult = await search(this.db, {
+                    term: expandedQuery,
+                    tolerance: 2,
+                    properties: ['description', 'path'],
+                    boost: {
+                        description: 5.0,
+                        path: 10.0
+                    },
+                    vector: {
+                        value: embedding,
+                        property: 'embedding'
+                    },
+                    mode: 'hybrid',
+                    similarity: 0,
+                    where,
+                    limit: 1000,
+                    offset: 0
+                });
+            }
+            else {
+                // BM25-only fallback (no embedding model available)
+                searchResult = await search(this.db, {
+                    term: expandedQuery,
+                    tolerance: 2,
+                    properties: ['description', 'path'],
+                    boost: {
+                        description: 5.0,
+                        path: 10.0
+                    },
+                    where,
+                    limit: 1000,
+                    offset: 0
+                });
+            }
             // 5. Threshold Filtering & Mapping with Structural Analysis
             const results = [];
             for (const hit of searchResult.hits) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fmea-api-mcp-server",
-  "version": "1.1.28",
+  "version": "1.1.30",
   "description": "MCP server for serving API documentation from endpoints directory",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.25.2",
     "@orama/orama": "^3.1.18",
-    "@xenova/transformers": "^2.17.2",
+    "fastembed": "^2.1.0",
     "stemmer": "^2.0.1",
     "zod": "^3.22.4"
   },
@@ -39,9 +39,6 @@
     "eslint": "^9.39.2",
     "typescript": "^5.3.0"
   },
-  "overrides": {
-    "sharp": "^0.33.5"
-  },
   "files": [
     "dist",
     "endpoints",