mcp-meilisearch 1.4.14 → 1.4.16

package/README.md

@@ -97,21 +97,28 @@ await client.connectToServer("http://localhost:4995/mcp");
 const result = await client.callTool("global-search", {
   q: "search kiosco antonio",
 });
+```
 
-// Use AI inference to choose the most appropriate tool
+#### Client Methods
 
-const result = await client.callToolWithAI("Find articles about cucumber", {
-  provideSummary: true,
-});
-console.log(`Tool used: ${result.toolUsed}`);
-console.log(`Reasoning: ${result.reasoning}`);
-console.log(`Results: ${JSON.stringify(result.data)}`);
-console.log(`Summary: ${result.summary}`);
-```
+##### `callTool(name, args)`
+
+Calls a specific tool on the MCP server with optional arguments.
+
+**Parameters:**
+
+- `name`: String - The name of the tool to call
+- `args`: Object (Optional) - Arguments to pass to the tool
+
+##### `processSummary(query)`
+
+Processes data using AI to generate a human-readable summary.
+
+**Parameters:**
 
-#### AI Inference Client Methods
+- `query`: Any - The data to be summarized
 
-#### `callToolWithAI(query, options)`
+##### `callToolWithAI(query, options)`
 
 Processes a user query through AI to determine and execute the most appropriate tool.
 
@@ -120,8 +127,7 @@ Processes a user query through AI to determine and execute the most appropriate
 - `query`: String - The user's query or request to be processed
 - `options`: Object (Optional) - Configuration options
   - `specificTools`: String[] (Optional) - Restricts tool selection to this list of tool names
-  - `justReasoning`: Boolean (Optional) - When set to `true`, returns only the AI's reasoning without executing the
-    selected tool
+  - `justReasoning`: Boolean (Optional) - When set to `true`, returns only the AI's reasoning without executing the selected tool
   - `provideSummary`: Boolean (Optional) - When set to `true`, generates a concise summary of the search results along with the regular response
 
 ### Starting the Server

package/dist/client.d.ts

@@ -1,16 +1,18 @@
-interface AIToolClientOptions {
-    specificTools?: string[];
-    justReasoning?: boolean;
-    provideSummary?: boolean;
-}
-interface AIToolClientResponse {
+interface ToolClientResponse {
     data?: any;
-    summary?: any;
     error?: string;
     success: boolean;
+}
+interface SearchToolClientResponse extends ToolClientResponse {
+    summary?: any;
     toolUsed?: string;
     reasoning?: string;
 }
+interface SearchToolClientOptions {
+    specificTools?: string[];
+    justReasoning?: boolean;
+    provideSummary?: boolean;
+}
 export declare class MCPClient {
     /**
      * Indicates whether the client is connected to the MCP server
@@ -52,8 +54,6 @@ export declare class MCPClient {
      * @throws Error if connection fails after 5 attempts
      */
     connectToServer(serverUrl: string): Promise<void>;
-    private listTools;
-    private setUpNotifications;
     /**
      * Calls a tool on the MCP server with optional arguments
      * Parses and processes the response from the server
@@ -62,11 +62,7 @@ export declare class MCPClient {
      * @throws Error if the tool call fails
      * @returns Object containing success status and either data or error message
      */
-    callTool(name: string, args?: Record<string, any>): Promise<{
-        success: boolean;
-        data?: any;
-        error?: string;
-    }>;
+    callTool(name: string, args?: Record<string, any>): Promise<ToolClientResponse>;
     /**
      * Process a user query through the AI to determine which tool to use
      * @param query The user's query
@@ -77,13 +73,21 @@ export declare class MCPClient {
      * @throws Error if AI inference fails
      * @returns The result of calling the selected tool, or an error
      */
-    callToolWithAI(query: string, options?: AIToolClientOptions): Promise<AIToolClientResponse>;
-    private setUpTransport;
+    callToolWithAI(query: string, options?: SearchToolClientOptions): Promise<SearchToolClientResponse>;
+    /**
+     * Process a summary text using AI
+     * @param query The natural language query to process
+     * @throws Error if AI inference fails
+     */
+    processSummary(query: any): Promise<ToolClientResponse>;
     /**
      * Closes the connection to the server and resets the connection state
      * Called automatically on transport error or can be called manually
      */
     cleanup(): Promise<void>;
+    private listTools;
+    private setUpNotifications;
+    private setUpTransport;
 }
 export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,UAAU,oBAAoB;IAC5B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,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;;;;;;;;;OASG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,oBAAoB,CAAC;IA2DhC,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,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,wBAAyB,SAAQ,kBAAkB;IAC3D,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,uBAAuB;IAC/B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,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;IAuBvD;;;;;;;OAOG;IACG,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACzB,OAAO,CAAC,kBAAkB,CAAC;IA2C9B;;;;;;;;;OASG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,wBAAwB,CAAC;IAuDpC;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAU7D;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAMhB,SAAS;IA0BvB,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,cAAc;CAIvB"}

package/dist/client.js

@@ -63,38 +63,6 @@ export class MCPClient {
             await this.connectToServer(serverUrl);
         }
     }
-    async listTools() {
-        try {
-            const toolsResult = await this.client.listTools();
-            if (!toolsResult) {
-                this.tools = [];
-            }
-            else if (toolsResult.tools && Array.isArray(toolsResult.tools)) {
-                this.tools = toolsResult.tools
-                    .filter(({ annotations }) => annotations?.category !== "core")
-                    .map((tool) => ({
-                    name: tool.name,
-                    description: tool.description ?? "",
-                    parameters: tool.parameters || {},
-                }));
-            }
-            else {
-                this.tools = [];
-            }
-        }
-        catch (error) {
-            this.tools = [];
-        }
-        finally {
-            if (this.toolsUpdatedCallback) {
-                this.toolsUpdatedCallback([...this.tools]);
-            }
-        }
-    }
-    setUpNotifications() {
-        this.client.setNotificationHandler(LoggingMessageNotificationSchema, console.info);
-        this.client.setNotificationHandler(ToolListChangedNotificationSchema, this.listTools);
-    }
     /**
      * Calls a tool on the MCP server with optional arguments
      * Parses and processes the response from the server
@@ -183,11 +151,7 @@ export class MCPClient {
                 toolUsed: toolName,
             };
             if (provideSummary) {
-                const summary = await this.callTool("process-ai-text", {
-                    query: JSON.stringify(toolResult.data),
-                });
-                if (!summary.success)
-                    console.error(summary);
+                const summary = await this.processSummary(toolResult.data);
                 response["summary"] = summary.data;
             }
             return response;
@@ -200,10 +164,18 @@ export class MCPClient {
             };
         }
     }
-    setUpTransport() {
-        if (this.transport == null)
-            return;
-        this.transport.onerror = this.cleanup;
+    /**
+     * Process a summary text using AI
+     * @param query The natural language query to process
+     * @throws Error if AI inference fails
+     */
+    async processSummary(query) {
+        const result = await this.callTool("process-ai-text", {
+            query: JSON.stringify(query),
+        });
+        if (!result.success)
+            console.error(result);
+        return result;
     }
     /**
      * Closes the connection to the server and resets the connection state
@@ -215,4 +187,41 @@ export class MCPClient {
         await this.client.close();
         this.isConnected = false;
     }
+    async listTools() {
+        try {
+            const toolsResult = await this.client.listTools();
+            if (!toolsResult) {
+                this.tools = [];
+            }
+            else if (toolsResult.tools && Array.isArray(toolsResult.tools)) {
+                this.tools = toolsResult.tools
+                    .filter(({ annotations }) => annotations?.category !== "core")
+                    .map((tool) => ({
+                    name: tool.name,
+                    parameters: tool.parameters || {},
+                    description: tool.description ?? "",
+                }));
+            }
+            else {
+                this.tools = [];
+            }
+        }
+        catch (error) {
+            this.tools = [];
+        }
+        finally {
+            if (this.toolsUpdatedCallback) {
+                this.toolsUpdatedCallback([...this.tools]);
+            }
+        }
+    }
+    setUpNotifications() {
+        this.client.setNotificationHandler(LoggingMessageNotificationSchema, console.info);
+        this.client.setNotificationHandler(ToolListChangedNotificationSchema, this.listTools);
+    }
+    setUpTransport() {
+        if (this.transport == null)
+            return;
+        this.transport.onerror = this.cleanup;
+    }
 }

package/package.json

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