mcp-meilisearch 1.3.10 → 1.4.1

package/README.md

@@ -106,7 +106,16 @@ console.log(`Results: ${JSON.stringify(result.data)}`);
 
 #### AI Inference Client Methods
 
-- `callToolWithAI(query: string, specificTools?: string[])`: Process a user query with AI inference, optionally limiting to specific tools.
+#### `callToolWithAI(query, options)`
+
+Processes a user query through AI to determine and execute the most appropriate tool.
+
+**Parameters:**
+
+- `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
 
 ### Starting the Server
 
@@ -304,7 +313,7 @@ The MCP server exposes various tools that allow you to interact with Meilisearch
 
 - **Description**: Perform multiple searches in one request.
 - **Parameters**:
-  - `searches` (string, required): JSON array of search queries, each with indexUid and q fields.
+  - `queries` (string, required): JSON array of search queries, each containing the same parameters as the `search` tool.
 
 #### global-search
 

package/dist/client.d.ts

@@ -46,6 +46,7 @@ export declare class MCPClient {
      * Parses and processes the response from the server
      * @param name The name of the tool to call
      * @param args Optional arguments to pass to the tool
+     * @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<{
@@ -56,10 +57,16 @@ export declare class MCPClient {
     /**
      * Process a user query through the AI to determine which tool to use
      * @param query The user's query
-     * @param specificTools Optional array of specific tools to consider
+     * @param options Options for the AI processing
+     * @param options.specificTools Optional array of specific tool names to consider
+     * @param options.justReasoning If true, only returns the reasoning without calling the tool
+     * @throws Error if AI inference fails
      * @returns The result of calling the selected tool, or an error
      */
-    callToolWithAI(query: string, specificTools?: string[]): Promise<{
+    callToolWithAI(query: string, options?: {
+        specificTools?: string[];
+        justReasoning?: boolean;
+    }): Promise<{
         success: boolean;
         data?: any;
         error?: string;

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;;;;;;OAMG;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;;;;;OAKG;IACG,cAAc,CAClB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,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;IAmCF,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;IA6CF,OAAO,CAAC,cAAc;IAKtB;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAK/B"}

package/dist/client.js

@@ -100,6 +100,7 @@ export class MCPClient {
      * Parses and processes the response from the server
      * @param name The name of the tool to call
      * @param args Optional arguments to pass to the tool
+     * @throws Error if the tool call fails
      * @returns Object containing success status and either data or error message
      */
     async callTool(name, args) {
@@ -143,10 +144,14 @@ export class MCPClient {
     /**
      * Process a user query through the AI to determine which tool to use
      * @param query The user's query
-     * @param specificTools Optional array of specific tools to consider
+     * @param options Options for the AI processing
+     * @param options.specificTools Optional array of specific tool names to consider
+     * @param options.justReasoning If true, only returns the reasoning without calling the tool
+     * @throws Error if AI inference fails
      * @returns The result of calling the selected tool, or an error
      */
-    async callToolWithAI(query, specificTools) {
+    async callToolWithAI(query, options = {}) {
+        const { specificTools, justReasoning } = options;
         try {
             const result = await this.callTool("process-ai-query", {
                 query,
@@ -161,6 +166,13 @@ export class MCPClient {
                     error: "AI could not determine which tool to use for this query",
                 };
             }
+            if (justReasoning) {
+                return {
+                    reasoning,
+                    success: true,
+                    toolUsed: toolName,
+                };
+            }
             const toolResult = await this.callTool(toolName, parameters);
             return {
                 ...toolResult,

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

@@ -93,7 +93,7 @@ export const registerSearchTools = (server) => {
     server.tool("multi-search", "Perform multiple searches in one request", {
         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."),
+            .describe("JSON array of search queries, each containing the same parameters as the `search` tool"),
     }, { category: "meilisearch" }, async ({ queries }) => {
         try {
             // Ensure queries is an array
@@ -130,7 +130,7 @@ export const registerSearchTools = (server) => {
             return createErrorResponse(error);
         }
     });
-    server.tool("global-search", "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/package.json

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