mcp-meilisearch 1.4.1 → 1.4.4

package/README.md

@@ -63,14 +63,15 @@ pnpm add mcp-meilisearch
 - `aiProviderApiKey`: AI provider API key for AI inference
 - `llmModel`: AI model to use (Default: "gpt-3.5-turbo")
 
-##### Using OpenRouter as AI Provider
+Please be aware that not all models support function calling, which is required for proper AI inference in this package. Make sure to select a model that supports the tools parameter.
 
-When setting `aiProviderName` to "openrouter", please be aware that not all models support function calling, which is required for proper AI inference in this package. Make sure to select a model that supports the tools parameter.
+| Provider    | Supported Models                                                                                         |
+| ----------- | -------------------------------------------------------------------------------------------------------- |
+| OpenAI      | [GPT-4, GPT-3.5-turbo and other compatible models](https://platform.openai.com/docs/models)              |
+| OpenRouter  | [Models with tools parameter support](https://openrouter.ai/models?fmt=cards&supported_parameters=tools) |
+| HuggingFace | [Models with function calling capability](https://huggingface.co/models?other=function+calling)          |
 
-You can find a list of OpenRouter models that support function calling at:
-https://openrouter.ai/models?fmt=cards&supported_parameters=tools
-
-Example configuration with OpenRouter:
+#### Example server setup
 
 ```typescript
 await mcpMeilisearchServer({

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;IACpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAS;IAE7B;;;OAGG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,EAAE,CAAM;IAET,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,oBAAoB,CAEZ;gBAEJ,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI;IAKzE;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhE;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBzC,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAW1B;;;;;;;OAOG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA2CF;;;;;;;;OAQG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAClE,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IA6CF,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;IACpB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAS;IAE7B;;;OAGG;IACH,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,EAAE,CAAM;IAET,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,oBAAoB,CAEZ;gBAEJ,UAAU,EAAE,MAAM;IAI9B;;;OAGG;IACH,sBAAsB,CACpB,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI;IAKzE;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAOhE;;;;OAIG;IACG,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAuBzC,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAW1B;;;;;;;OAOG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IA2CF;;;;;;;;OAQG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAO,GAClE,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,CAAC;QACX,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IAsCF,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/client.js

@@ -160,12 +160,6 @@ export class MCPClient {
             if (!result.success)
                 return result;
             const { toolName, parameters, reasoning } = result.data;
-            if (!toolName) {
-                return {
-                    success: false,
-                    error: "AI could not determine which tool to use for this query",
-                };
-            }
             if (justReasoning) {
                 return {
                     reasoning,

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,OAAO,EAAyB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAU1E;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,aAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CA2HtB;AAuCD,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAK7B,OAAO,EAAE,aAAa,EAAyB,MAAM,oBAAoB,CAAC;AAE1E;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,aAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAkEtB;AAwCD,eAAe,oBAAoB,CAAC"}

package/dist/index.js

@@ -1,16 +1,7 @@
 import { createServer } from "node:http";
-import { parse as parseUrl } from "node:url";
 import { AIService } from "./utils/ai-handler.js";
-import { initServer } from "./server.js";
 import { configHandler } from "./utils/config-handler.js";
-import { createErrorResponse } from "./utils/error-handler.js";
-const defaultOptions = {
-    aiProviderApiKey: "",
-    meilisearchApiKey: "",
-    llmModel: "gpt-3.5-turbo",
-    aiProviderName: "openai",
-    meilisearchHost: "http://localhost:7700",
-};
+import { initServer, defaultOptions } from "./server.js";
 /**
  * Start a MCP server
  * @param options Configuration options for the MCP server
@@ -37,57 +28,13 @@ export async function mcpMeilisearchServer(options = defaultOptions) {
     let mcpServerInstance = null;
     const mcpEndpoint = options.mcpEndpoint || "/mcp";
     const server = createServer(async (req, res) => {
-        res.setHeader("Access-Control-Allow-Origin", "*");
-        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
-        res.setHeader("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept, mcp-session-id");
-        if (req.method === "OPTIONS") {
-            res.statusCode = 200;
-            res.end();
-            return;
-        }
-        const parsedUrl = parseUrl(req.url || "/", true);
-        const pathname = parsedUrl.pathname || "/";
-        if (!pathname.startsWith(mcpEndpoint)) {
-            res.statusCode = 404;
-            res.end(JSON.stringify({ error: "Not found" }));
-            return;
-        }
         if (!mcpServerInstance) {
-            console.error("MCP server not initialized yet");
             res.statusCode = 503;
             res.setHeader("Content-Type", "application/json");
-            res.end(JSON.stringify(createErrorResponse("MCP server not initialized yet")));
+            res.end(JSON.stringify({ error: "MCP server not initialized yet" }));
             return;
         }
-        if (req.method === "GET") {
-            await mcpServerInstance.handleGetRequest(req, res);
-            return;
-        }
-        if (req.method === "POST") {
-            let body = "";
-            req.on("data", (chunk) => {
-                body += chunk.toString();
-            });
-            req.on("end", async () => {
-                try {
-                    const jsonBody = JSON.parse(body);
-                    if (mcpServerInstance) {
-                        await mcpServerInstance.handlePostRequest(req, res, jsonBody);
-                    }
-                    else {
-                        res.statusCode = 503;
-                        res.end(JSON.stringify(createErrorResponse("MCP server not initialized yet")));
-                    }
-                }
-                catch {
-                    res.statusCode = 400;
-                    res.end(JSON.stringify(createErrorResponse("Invalid JSON body")));
-                }
-            });
-            return;
-        }
-        res.statusCode = 405;
-        res.end(JSON.stringify(createErrorResponse("Method not allowed")));
+        await mcpServerInstance.handleHttpRequest(req, res, mcpEndpoint);
     });
     await new Promise((resolve) => {
         server.listen(httpPort, () => {
@@ -141,6 +88,7 @@ if (import.meta.url === `file://${process.argv?.[1]}`) {
                 break;
             case "aiApiKey":
                 options.aiProviderApiKey = value;
+                break;
             case "aiProvider":
                 options.aiProviderName = value;
                 break;

package/dist/server.d.ts

@@ -1,22 +1,13 @@
 import { IncomingMessage, ServerResponse } from "http";
+import { ServerOptions } from "./types/options.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * Configuration for the MCP server
- */
-interface ServerConfig {
-    host: string;
-    apiKey: string;
-    httpPort: number;
-    mcpEndpoint: string;
-    sessionTimeout: number;
-    sessionCleanupInterval: number;
-}
 /**
  * Return type for the initServer function
  */
 interface ServerInstance {
     mcpServer: MCPServer;
 }
+export declare const defaultOptions: ServerOptions;
 /**
  * Implementation of an MCP server for Meilisearch
  */
@@ -32,7 +23,14 @@ export declare class MCPServer {
      * @param server The underlying MCP server implementation
      * @param config Configuration options
      */
-    constructor(server: McpServer, config?: Partial<ServerConfig>);
+    constructor(server: McpServer, config?: Partial<ServerOptions>);
+    /**
+     * Handles an HTTP request and routes it to the appropriate handler
+     * @param req The HTTP request
+     * @param res The HTTP response
+     * @param mcpEndpoint The MCP endpoint path
+     */
+    handleHttpRequest(req: IncomingMessage, res: ServerResponse, mcpEndpoint: string): Promise<void>;
     /**
      * Handles an HTTP GET request
      * @param req The HTTP request
@@ -93,9 +91,10 @@ export declare class MCPServer {
 /**
  * Initialize the MCP server with the specified transport
  * @param transport The transport type to use ("stdio" or "http")
+ * @param config Configuration options for the server
  * @returns A promise that resolves to the server instances
  * @throws Error if the transport type is unsupported
  */
-export declare const initServer: (transport: "stdio" | "http", config?: Partial<ServerConfig>) => Promise<ServerInstance>;
+export declare const initServer: (transport: "stdio" | "http", config?: Partial<ServerOptions>) => Promise<ServerInstance>;
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAUvD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE;;GAEG;AACH,UAAU,YAAY;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,SAAS,CAAC;CACtB;AAmBD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoB;IAE3D,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;OAIG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAOjE;;;;OAIG;IACG,gBAAgB,CACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;OAKG;YACW,uBAAuB;IAuCrC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA0B/B;AA+DD;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,OAAO,GAAG,MAAM,EAC3B,SAAS,OAAO,CAAC,YAAY,CAAC,KAC7B,OAAO,CAAC,cAAc,CAcxB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAOvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,SAAS,CAAC;CACtB;AASD,eAAO,MAAM,cAAc,EAAE,aAO5B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoB;IAE3D,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;OAIG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAOlE;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IA+ChB;;;;OAIG;IACG,gBAAgB,CACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;OAKG;YACW,uBAAuB;IAuCrC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA2B/B;AA+DD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,WAAW,OAAO,GAAG,MAAM,EAC3B,SAAS,OAAO,CAAC,aAAa,CAAC,KAC9B,OAAO,CAAC,cAAc,CAcxB,CAAC"}

package/dist/server.js

@@ -12,13 +12,13 @@ import registerDocumentTools from "./tools/meilisearch/document-tools.js";
 import registerSettingsTools from "./tools/meilisearch/settings-tools.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-const defaultConfig = {
+export const defaultOptions = {
     httpPort: 4995,
     mcpEndpoint: "/mcp",
     sessionTimeout: 3600000,
     sessionCleanupInterval: 60000,
-    apiKey: process.env.MEILISEARCH_API_KEY || "",
-    host: process.env.MEILISEARCH_HOST || "http://localhost:7700",
+    meilisearchApiKey: process.env.MEILISEARCH_API_KEY || "",
+    meilisearchHost: process.env.MEILISEARCH_HOST || "http://localhost:7700",
 };
 /**
  * Implementation of an MCP server for Meilisearch
@@ -37,9 +37,52 @@ export class MCPServer {
      */
     constructor(server, config = {}) {
         this.server = server;
-        this.config = { ...defaultConfig, ...config };
+        this.config = { ...defaultOptions, ...config };
         this.startSessionCleanup();
     }
+    /**
+     * Handles an HTTP request and routes it to the appropriate handler
+     * @param req The HTTP request
+     * @param res The HTTP response
+     * @param mcpEndpoint The MCP endpoint path
+     */
+    async handleHttpRequest(req, res, mcpEndpoint) {
+        res.setHeader("Access-Control-Allow-Origin", "*");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Origin, X-Requested-With, Content-Type, Accept, mcp-session-id");
+        if (req.method === "OPTIONS") {
+            res.statusCode = 200;
+            res.end();
+            return;
+        }
+        const parsedUrl = new URL(req.url || "/", `http://${req.headers.host}`);
+        const pathname = parsedUrl.pathname || "/";
+        if (!pathname.startsWith(mcpEndpoint)) {
+            this.sendErrorResponse(res, 404, "Not found");
+            return;
+        }
+        if (req.method === "GET") {
+            await this.handleGetRequest(req, res);
+            return;
+        }
+        if (req.method === "POST") {
+            let body = "";
+            req.on("data", (chunk) => {
+                body += chunk.toString();
+            });
+            req.on("end", async () => {
+                try {
+                    const jsonBody = JSON.parse(body);
+                    await this.handlePostRequest(req, res, jsonBody);
+                }
+                catch (error) {
+                    this.sendErrorResponse(res, 400, "Invalid JSON body");
+                }
+            });
+            return;
+        }
+        this.sendErrorResponse(res, 405, "Method not allowed");
+    }
     /**
      * Handles an HTTP GET request
      * @param req The HTTP request
@@ -215,9 +258,10 @@ export class MCPServer {
      * Starts the session cleanup process
      */
     startSessionCleanup() {
+        const cleanupInterval = this.config.sessionCleanupInterval || 60000;
         this.cleanupInterval = setInterval(() => {
             this.cleanupExpiredSessions();
-        }, this.config.sessionCleanupInterval);
+        }, cleanupInterval);
     }
     /**
      * Removes expired sessions
@@ -225,8 +269,9 @@ export class MCPServer {
     cleanupExpiredSessions() {
         const now = Date.now();
         const expiredIds = [];
+        const sessionTimeout = this.config.sessionTimeout || 3600000;
         for (const [sessionId, info] of this.sessions.entries()) {
-            if (now - info.lastActivity > this.config.sessionTimeout) {
+            if (now - info.lastActivity > sessionTimeout) {
                 expiredIds.push(sessionId);
             }
         }
@@ -248,7 +293,7 @@ export class MCPServer {
     }
 }
 /**
- * Initialize the MCP server with HTTP transport using Vite
+ * Initialize the MCP server with HTTP transport
  */
 const initServerHTTPTransport = async (customConfig) => {
     const serverInstance = new McpServer({
@@ -296,6 +341,7 @@ const initServerStdioTransport = async (customConfig) => {
 /**
  * Initialize the MCP server with the specified transport
  * @param transport The transport type to use ("stdio" or "http")
+ * @param config Configuration options for the server
  * @returns A promise that resolves to the server instances
  * @throws Error if the transport type is unsupported
  */

package/dist/tools/core/ai-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/core/ai-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SAyEhD,CAAC;AAEF,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ai-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/core/ai-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAapE;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,SAAS,SAoDhD,CAAC;AAEF,eAAe,eAAe,CAAC"}

package/dist/tools/core/ai-tools.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import { AIService } from "../../utils/ai-handler.js";
 import { zodToJsonSchema } from "zod-to-json-schema";
+import { AIService } from "../../utils/ai-handler.js";
 import { createErrorResponse } from "../../utils/error-handler.js";
 /**
  * Register AI tools with the MCP server
@@ -28,35 +28,16 @@ export const registerAITools = (server) => {
             });
             aiService.setAvailableTools(availableTools);
             const result = await aiService.processQuery(query, specificTools);
-            if (!aiService.ensureInitialized()) {
-                return {
-                    isError: true,
-                    content: [
-                        {
-                            type: "text",
-                            text: "AI service not initialized. Please provide an API key.",
-                        },
-                    ],
-                };
-            }
-            if (!result) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: "AI couldn't determine an appropriate tool to use for this query.",
-                        },
-                    ],
-                };
-            }
+            if (result.error)
+                return createErrorResponse(result.error);
             return {
                 content: [
                     {
                         type: "text",
                         text: JSON.stringify({
                             toolName: result.toolName,
+                            reasoning: result.reasoning,
                             parameters: result.parameters,
-                            reasoning: result.reasoning || "No explanation provided",
                         }, null, 2),
                     },
                 ],

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

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAEvC;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}

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

@@ -4,10 +4,18 @@ interface AITool {
     description: string;
     parameters: Record<string, any>;
 }
-interface AIToolResponse {
-    toolName: string;
+interface AIToolResponseBase {
     reasoning?: string | null;
-    parameters: Record<string, any>;
+}
+interface AIToolSuccessResponse extends AIToolResponseBase {
+    error: null;
+    toolName: string;
+    parameters: Record<string, unknown>;
+}
+interface AIToolErrorResponse extends AIToolResponseBase {
+    error: string;
+    toolName?: string;
+    parameters?: Record<string, unknown>;
 }
 /**
  * AI Inference Service
@@ -16,7 +24,6 @@ interface AIToolResponse {
  * to use based on the user's query
  */
 export declare class AIService {
-    private apiKey;
     private model;
     private static instance;
     private static serverInitialized;
@@ -41,7 +48,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, forceNewInit?: boolean): void;
+    initialize(apiKey: string, provider?: AiProviderNameOptions, model?: string): void;
     /**
      * Set the available tools that can be used by the AI
      * @param tools Array of tools with name, description, and parameters
@@ -66,7 +73,7 @@ export declare class AIService {
      * @param specificTools Optional array of specific tool names to consider
      * @returns Object containing the selected tool name and parameters
      */
-    processQuery(query: string, specificTools?: string[]): Promise<AIToolResponse | null>;
+    processQuery(query: string, specificTools?: string[]): Promise<AIToolSuccessResponse | AIToolErrorResponse>;
     private processOpenAIQuery;
     private processHuggingFaceQuery;
 }

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":"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"}
+{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAmBD,UAAU,kBAAkB;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,UAAU,qBAAsB,SAAQ,kBAAkB;IACxD,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,UAAU,mBAAoB,SAAQ,kBAAkB;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;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,CAAgD;IAC9D,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;IAyBP;;;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,qBAAqB,GAAG,mBAAmB,CAAC;YA4BzC,kBAAkB;YAyClB,uBAAuB;CAqCtC"}

package/dist/utils/ai-handler.js

@@ -10,7 +10,6 @@ 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;
@@ -40,27 +39,23 @@ 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, forceNewInit = false) {
-        if (AIService.serverInitialized && !forceNewInit) {
+    initialize(apiKey, provider = "openai", model) {
+        if (AIService.serverInitialized) {
             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.apiKey });
-                break;
-            case "openrouter":
-                this.client = new OpenAI({
-                    apiKey: this.apiKey,
-                    baseURL: OPEN_ROUTER_API.baseURL,
-                });
+                this.client = new OpenAI({ apiKey });
                 break;
             case "huggingface":
-                this.client = new InferenceClient(this.apiKey);
+                this.client = new InferenceClient(apiKey);
+                break;
+            case "openrouter":
+                this.client = new OpenAI({ apiKey, baseURL: OPEN_ROUTER_API.baseURL });
                 break;
             default:
                 throw new Error(`Unsupported AI provider: ${this.provider}`);
@@ -118,8 +113,11 @@ export class AIService {
      * @returns Object containing the selected tool name and parameters
      */
     async processQuery(query, specificTools) {
-        if (!this.ensureInitialized())
-            return null;
+        if (!this.ensureInitialized()) {
+            return {
+                error: "AI service not initialized. Please provide an API key.",
+            };
+        }
         const mentionedTools = this.extractToolNames(query);
         const toolsToUse = specificTools || (mentionedTools.length ? mentionedTools : undefined);
         const tools = this.getToolDefinitions(toolsToUse);
@@ -134,54 +132,67 @@ export class AIService {
         return await this.processOpenAIQuery(tools, messages);
     }
     async processOpenAIQuery(tools, messages) {
-        const client = this.client;
-        const response = await client.chat.completions.create({
-            tools,
-            messages,
-            model: this.model,
-        });
-        if ("error" in response) {
-            console.error("Error in OpenAI API call:", response);
-            return null;
+        try {
+            const client = this.client;
+            const response = await client.chat.completions.create({
+                tools,
+                messages,
+                model: this.model,
+                tool_choice: "required",
+            });
+            if (!response.choices?.length) {
+                return { error: "No choices returned from OpenAI" };
+            }
+            const message = response.choices[0].message;
+            if (message.content) {
+                const toolCall = markdownToJson(message.content);
+                if (!toolCall) {
+                    return {
+                        error: `Invalid tool call format in content: ${message.content}`,
+                    };
+                }
+                return {
+                    error: null,
+                    toolName: toolCall.name,
+                    parameters: toolCall.parameters,
+                    reasoning: JSON.stringify(toolCall, null, 2),
+                };
+            }
+            return { error: "No tool call or content in OpenAI response" };
+        }
+        catch (error) {
+            return { error: `OpenAI API error: ${error}` };
         }
-        if (!response?.choices.length)
-            return null;
-        const message = response.choices[0].message;
-        if (!message.content)
-            return null;
-        const toolCall = markdownToJson(message.content);
-        if (!toolCall)
-            return null;
-        return {
-            toolName: toolCall.name,
-            parameters: toolCall.parameters,
-            reasoning: JSON.stringify(toolCall, null, 2),
-        };
     }
     async processHuggingFaceQuery(tools, messages) {
-        const client = this.client;
-        const response = await client.chatCompletion({
-            tools,
-            messages,
-            max_tokens: 512,
-            model: this.model,
-        });
-        if ("error" in response) {
-            console.error("Error in HugginFace call:", response);
-            return null;
+        try {
+            const client = this.client;
+            const response = await client.chatCompletion({
+                tools,
+                messages,
+                model: this.model,
+                tool_choice: "required",
+            });
+            if (!response.choices?.length) {
+                return { error: "No choices in Hugging Face response" };
+            }
+            const message = response.choices[0].message;
+            if (message.content) {
+                const toolCall = markdownToJson(message.content);
+                if (!toolCall) {
+                    return { error: `Invalid tool call format in content: ${response}` };
+                }
+                return {
+                    error: null,
+                    toolName: toolCall.name,
+                    parameters: toolCall.parameters,
+                    reasoning: JSON.stringify(toolCall, null, 2),
+                };
+            }
+            return { error: "No tool call or content in Hugging Face response" };
+        }
+        catch (error) {
+            return { error: `Hugging Face API error: ${error}` };
         }
-        if (!response?.choices.length)
-            return null;
-        const message = response.choices[0].message;
-        if (!message.content)
-            return null;
-        const toolCall = markdownToJson(message.content);
-        if (!toolCall)
-            return null;
-        return {
-            toolName: toolCall.name,
-            parameters: toolCall.parameters,
-            reasoning: JSON.stringify(toolCall, null, 2),
-        };
     }
 }

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

@@ -1,6 +1,3 @@
-/**
- * Error handling utilities for Meilisearch API responses
- */
 /**
  * Formats Meilisearch API errors for consistent error messaging
  *

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

@@ -1 +1 @@
-{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,MAU3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG;;;;;;CAK7C,CAAC;;4BAvBoC,GAAG,KAAG,MAAM;iCAkBP,GAAG;;;;;;;;AAO9C,wBAGE"}
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,GAAG,KAAG,MAU3C,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,GAAG;;;;;;CAK7C,CAAC;;4BAvBoC,GAAG,KAAG,MAAM;iCAkBP,GAAG;;;;;;;;AAO9C,wBAGE"}

package/dist/utils/error-handler.js

@@ -1,6 +1,3 @@
-/**
- * Error handling utilities for Meilisearch API responses
- */
 /**
  * Formats Meilisearch API errors for consistent error messaging
  *

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

@@ -1 +1 @@
-{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/utils/response-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA6BtE"}
+{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/utils/response-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAoCtE"}

package/dist/utils/response-handler.js

@@ -16,11 +16,19 @@ export function markdownToJson(markdownJsonString) {
     if (fenceMatch && fenceMatch[1]) {
         S = fenceMatch[1].trim();
     }
+    else {
+        const jsonTagRegex = /<json>\s*([\s\S]*?)\s*<\/json>/;
+        const jsonTagMatch = S.match(jsonTagRegex);
+        if (jsonTagMatch && jsonTagMatch[1]) {
+            S = jsonTagMatch[1].trim();
+        }
+    }
     if (S === "")
         return null;
     S = S.replace(/\/\/[^\r\n]*/g, "");
     S = S.replace(/\/\*[\s\S]*?\*\//g, "");
     S = S.replace(/,\s*([}\]])/g, "$1");
+    S = S.replace(/([{,]\s*)([a-zA-Z_][a-zA-Z0-9_]*)\s*:/g, '$1"$2":');
     try {
         const parsedJson = JSON.parse(S);
         return parseNestedJsonStrings(parsedJson);

package/package.json

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