mcp-meilisearch 1.3.9 → 1.3.10

package/README.md

@@ -92,7 +92,7 @@ const client = new MCPClient("mcp-meilisearch-client");
 
 await client.connectToServer("http://localhost:4995/mcp");
 
-const result = await client.callTool("search-across-all-indexes", {
+const result = await client.callTool("global-search", {
   q: "search kiosco antonio",
 });
 
@@ -306,7 +306,7 @@ The MCP server exposes various tools that allow you to interact with Meilisearch
 - **Parameters**:
   - `searches` (string, required): JSON array of search queries, each with indexUid and q fields.
 
-#### search-across-all-indexes
+#### global-search
 
 - **Description**: Search for a term across all available Meilisearch indexes and return combined results.
 - **Parameters**:

package/dist/tools/meilisearch/search-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/meilisearch/search-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkCpE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,SAoRpD,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/meilisearch/search-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwFpE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,SAAS,SA6NpD,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/dist/tools/meilisearch/search-tools.js

@@ -1,6 +1,59 @@
 import { z } from "zod";
 import apiClient from "../../utils/api-handler.js";
 import { createErrorResponse } from "../../utils/error-handler.js";
+const SearchParamsSchema = {
+    indexUid: z.string().describe("Unique identifier of the index"),
+    q: z.string().describe("Search query"),
+    limit: z
+        .number()
+        .min(1)
+        .optional()
+        .describe("Maximum number of results to return (default: 20)"),
+    offset: z
+        .number()
+        .min(0)
+        .optional()
+        .describe("Number of results to skip (default: 0)"),
+    filter: z.string().optional().describe("Filter query to apply"),
+    sort: z
+        .array(z.string())
+        .optional()
+        .describe('Attributes to sort by, e.g. ["price:asc"]'),
+    facets: z.array(z.string()).optional().describe("Facets to return"),
+    attributesToRetrieve: z
+        .array(z.string())
+        .optional()
+        .default(["*"])
+        .describe("Attributes to include in results"),
+    attributesToCrop: z
+        .array(z.string())
+        .optional()
+        .describe("Attributes to crop"),
+    cropLength: z
+        .number()
+        .optional()
+        .describe("Length at which to crop cropped attributes"),
+    attributesToHighlight: z
+        .array(z.string())
+        .optional()
+        .describe("Attributes to highlight"),
+    highlightPreTag: z
+        .string()
+        .optional()
+        .describe("Tag to insert before highlighted text"),
+    highlightPostTag: z
+        .string()
+        .optional()
+        .describe("Tag to insert after highlighted text"),
+    showMatchesPosition: z
+        .boolean()
+        .optional()
+        .describe("Whether to include match positions in results"),
+    matchingStrategy: z
+        .string()
+        .optional()
+        .describe("Matching strategy: 'all' or 'last'"),
+};
 /**
  * Register search tools with the MCP server
  *
@@ -8,59 +61,7 @@ import { createErrorResponse } from "../../utils/error-handler.js";
  */
 export const registerSearchTools = (server) => {
     // Search in an index
-    server.tool("search", "Search for documents in a Meilisearch index", {
-        indexUid: z.string().describe("Unique identifier of the index"),
-        q: z.string().describe("Search query"),
-        limit: z
-            .number()
-            .min(1)
-            .optional()
-            .describe("Maximum number of results to return (default: 20)"),
-        offset: z
-            .number()
-            .min(0)
-            .optional()
-            .describe("Number of results to skip (default: 0)"),
-        filter: z.string().optional().describe("Filter query to apply"),
-        sort: z
-            .array(z.string())
-            .optional()
-            .describe('Attributes to sort by, e.g. ["price:asc"]'),
-        facets: z.array(z.string()).optional().describe("Facets to return"),
-        attributesToRetrieve: z
-            .array(z.string())
-            .optional()
-            .default(["*"])
-            .describe("Attributes to include in results"),
-        attributesToCrop: z
-            .array(z.string())
-            .optional()
-            .describe("Attributes to crop"),
-        cropLength: z
-            .number()
-            .optional()
-            .describe("Length at which to crop cropped attributes"),
-        attributesToHighlight: z
-            .array(z.string())
-            .optional()
-            .describe("Attributes to highlight"),
-        highlightPreTag: z
-            .string()
-            .optional()
-            .describe("Tag to insert before highlighted text"),
-        highlightPostTag: z
-            .string()
-            .optional()
-            .describe("Tag to insert after highlighted text"),
-        showMatchesPosition: z
-            .boolean()
-            .optional()
-            .describe("Whether to include match positions in results"),
-        matchingStrategy: z
-            .string()
-            .optional()
-            .describe("Matching strategy: 'all' or 'last'"),
-    }, { category: "meilisearch" }, async ({ indexUid, q, limit, offset, filter, sort, facets, attributesToRetrieve, attributesToCrop, cropLength, attributesToHighlight, highlightPreTag, highlightPostTag, showMatchesPosition, matchingStrategy, }) => {
+    server.tool("search", "Search for documents in a Meilisearch index", SearchParamsSchema, { category: "meilisearch" }, async ({ indexUid, q, limit, offset, filter, sort, facets, attributesToRetrieve, attributesToCrop, cropLength, attributesToHighlight, highlightPreTag, highlightPostTag, showMatchesPosition, matchingStrategy, }) => {
         try {
             const response = await apiClient.post(`/indexes/${indexUid}/search`, {
                 q,
@@ -90,22 +91,20 @@ export const registerSearchTools = (server) => {
     });
     // Multi-search across multiple indexes
     server.tool("multi-search", "Perform multiple searches in one request", {
-        searches: z
-            .string()
-            .describe("JSON array of search queries, each with indexUid and q fields"),
-    }, { category: "meilisearch" }, async ({ searches }) => {
+        queries: z
+            .array(z.object(SearchParamsSchema))
+            .describe("JSON array of search queries, each with indexUid and q fields as required. Other fields of the SearchParams are optional."),
+    }, { category: "meilisearch" }, async ({ queries }) => {
         try {
-            // Parse the searches string to ensure it's valid JSON
-            const parsedSearches = JSON.parse(searches);
-            // Ensure searches is an array
-            if (!Array.isArray(parsedSearches)) {
+            // Ensure queries is an array
+            if (!Array.isArray(queries)) {
                 return {
                     isError: true,
-                    content: [{ type: "text", text: "Searches must be a JSON array" }],
+                    content: [{ type: "text", text: "Queries must be a JSON array" }],
                 };
             }
             // Ensure each search has at least indexUid
-            for (const search of parsedSearches) {
+            for (const search of queries) {
                 if (!search.indexUid) {
                     return {
                         isError: true,
@@ -119,7 +118,7 @@ export const registerSearchTools = (server) => {
                 }
             }
             const response = await apiClient.post("/multi-search", {
-                queries: parsedSearches,
+                queries,
             });
             return {
                 content: [
@@ -131,7 +130,7 @@ export const registerSearchTools = (server) => {
             return createErrorResponse(error);
         }
     });
-    server.tool("search-across-all-indexes", "Search for a term across all available Meilisearch indexes and return combined results.", {
+    server.tool("global-search", "Search for a term across all available Meilisearch indexes and return combined results.", {
         q: z.string().describe("Search query"),
         limit: z
             .number()

package/dist/types/enums.d.ts

@@ -0,0 +1,5 @@
+export declare enum OPEN_ROUTER_API {
+    baseURL = "https://openrouter.ai/api/v1",
+    keys = "https://openrouter.ai/api/v1/keys"
+}
+//# sourceMappingURL=enums.d.ts.map

package/dist/types/enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enums.d.ts","sourceRoot":"","sources":["../../src/types/enums.ts"],"names":[],"mappings":"AAAA,oBAAY,eAAe;IACzB,OAAO,iCAAiC;IACxC,IAAI,sCAAoB;CACzB"}

package/dist/types/enums.js

@@ -0,0 +1,5 @@
+export var OPEN_ROUTER_API;
+(function (OPEN_ROUTER_API) {
+    OPEN_ROUTER_API["baseURL"] = "https://openrouter.ai/api/v1";
+    OPEN_ROUTER_API["keys"] = "https://openrouter.ai/api/v1/keys";
+})(OPEN_ROUTER_API || (OPEN_ROUTER_API = {}));

package/dist/utils/ai-handler.d.ts

@@ -16,6 +16,7 @@ interface AIToolResponse {
  * to use based on the user's query
  */
 export declare class AIService {
+    private apiKey;
     private model;
     private static instance;
     private static serverInitialized;
@@ -40,7 +41,7 @@ export declare class AIService {
      * @param provider AI provider name (defaults to openai)
      * @param model Optional model to use (defaults to gpt-3.5-turbo)
      */
-    initialize(apiKey: string, provider?: AiProviderNameOptions, model?: string): void;
+    initialize(apiKey: string, provider?: AiProviderNameOptions, model?: string, forceNewInit?: boolean): void;
     /**
      * Set the available tools that can be used by the AI
      * @param tools Array of tools with name, description, and parameters

package/dist/utils/ai-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAiBD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,cAAc,CAIb;IAET;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IA4BP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAwBnB,kBAAkB;YAiClB,uBAAuB;CAiCtC"}
+{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAiBD,UAAU,cAAc;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,cAAc,CAIb;IAET;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,GAAE,OAAe,GAC5B,IAAI;IA6BP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAwBnB,kBAAkB;YAiClB,uBAAuB;CAiCtC"}

package/dist/utils/ai-handler.js

@@ -1,5 +1,6 @@
 import { OpenAI } from "openai";
 import systemPrompt from "../prompts/system.js";
+import { OPEN_ROUTER_API } from "../types/enums.js";
 import { markdownToJson } from "./response-handler.js";
 import { InferenceClient } from "@huggingface/inference";
 /**
@@ -9,6 +10,7 @@ import { InferenceClient } from "@huggingface/inference";
  * to use based on the user's query
  */
 export class AIService {
+    apiKey = "";
     model = "gpt-3.5-turbo";
     static instance = null;
     static serverInitialized = false;
@@ -38,26 +40,27 @@ export class AIService {
      * @param provider AI provider name (defaults to openai)
      * @param model Optional model to use (defaults to gpt-3.5-turbo)
      */
-    initialize(apiKey, provider = "openai", model) {
-        if (AIService.serverInitialized) {
+    initialize(apiKey, provider = "openai", model, forceNewInit = false) {
+        if (AIService.serverInitialized && !forceNewInit) {
             console.warn("AIService has already been initialized by the server.");
             return;
         }
+        this.apiKey = apiKey;
         this.provider = provider;
         if (model)
             this.model = model;
         switch (this.provider) {
             case "openai":
-                this.client = new OpenAI({ apiKey });
+                this.client = new OpenAI({ apiKey: this.apiKey });
                 break;
             case "openrouter":
                 this.client = new OpenAI({
-                    apiKey,
-                    baseURL: "https://openrouter.ai/api/v1",
+                    apiKey: this.apiKey,
+                    baseURL: OPEN_ROUTER_API.baseURL,
                 });
                 break;
             case "huggingface":
-                this.client = new InferenceClient(apiKey);
+                this.client = new InferenceClient(this.apiKey);
                 break;
             default:
                 throw new Error(`Unsupported AI provider: ${this.provider}`);
@@ -126,9 +129,9 @@ export class AIService {
             { role: "user", content: query },
         ];
         if (this.provider === "huggingface") {
-            return this.processHuggingFaceQuery(tools, messages);
+            return await this.processHuggingFaceQuery(tools, messages);
         }
-        return this.processOpenAIQuery(tools, messages);
+        return await this.processOpenAIQuery(tools, messages);
     }
     async processOpenAIQuery(tools, messages) {
         const client = this.client;

package/dist/utils/response-handler.js

@@ -23,7 +23,7 @@ export function markdownToJson(markdownJsonString) {
     S = S.replace(/,\s*([}\]])/g, "$1");
     try {
         const parsedJson = JSON.parse(S);
-        return parsedJson;
+        return parseNestedJsonStrings(parsedJson);
     }
     catch (error) {
         console.error("Failed to parse JSON after transformations.");
@@ -33,3 +33,32 @@ export function markdownToJson(markdownJsonString) {
         return null;
     }
 }
+function tryParseJsonString(str) {
+    try {
+        if (typeof str === "string" &&
+            ((str.startsWith("[") && str.endsWith("]")) ||
+                (str.startsWith("{") && str.endsWith("}")))) {
+            return JSON.parse(str);
+        }
+        return str;
+    }
+    catch {
+        return str;
+    }
+}
+function parseNestedJsonStrings(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map((item) => parseNestedJsonStrings(item));
+    }
+    else if (obj !== null && typeof obj === "object") {
+        const result = {};
+        for (const key of Object.keys(obj)) {
+            result[key] = parseNestedJsonStrings(obj[key]);
+        }
+        return result;
+    }
+    else if (typeof obj === "string") {
+        return tryParseJsonString(obj);
+    }
+    return obj;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meilisearch",
-  "version": "1.3.9",
+  "version": "1.3.10",
   "description": "Model Context Protocol (MCP) implementation for Meilisearch",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",