mcp-meilisearch 1.2.8 → 1.3.1

package/README.md

@@ -6,13 +6,15 @@ A Model Context Protocol (MCP) server implementation that provides a bridge betw
 
 - **MCP Server**: Exposes Meilisearch APIs as tools using the Model Context Protocol.
 - **Web Client Demo**: A demo interface showcasing search functionalities.
+- **AI Inference**: Intelligent tool selection based on user queries.
 
 ## Key Features
 
 - **Multiple Transport Options**: Supports both STDIO and StreamableHTTP transports.
 - **Real-time Communication**: Enables seamless interaction between clients and the server.
 - **Meilisearch API Support**: Full access to Meilisearch functionalities.
-- **Web Client Demo**: Updated interface for demonstrating search capabilities.
+- **Web Client Demo**: Updated interface showcasing search capabilities and features.
+- **AI Inference**: Leverages LLMs from providers such as OpenAI, Hugging Face, or Anthropic to intelligently determine and utilize the most suitable tool for user queries.
 
 ## Getting Started
 
@@ -21,6 +23,7 @@ A Model Context Protocol (MCP) server implementation that provides a bridge betw
 - Node.js v20 or higher.
 - A running Meilisearch instance (local or remote).
 - API key for Meilisearch (if required).
+- AI provider API key (if using AI inference).
 
 ### Installation
 
@@ -55,20 +58,54 @@ pnpm add mcp-meilisearch
 - `sessionTimeout`: Session timeout in milliseconds (Default: 3600000)
 - `sessionCleanupInterval`: Session cleanup interval in milliseconds (Default: 60000)
 
+#### AI Inference Options
+
+- `providerApiKey`: AI provider API key for AI inference
+- `llmModel`: AI model to use (Default: "gpt-3.5-turbo")
+
 ### Using the MCPClient
 
-The package also exports the MCPClient class for client-side integration:
+The package exports the MCPClient class for client-side integration:
 
 ```typescript
 import { MCPClient } from "mcp-meilisearch/client";
 
 const client = new MCPClient("mcp-meilisearch-client");
+
 await client.connectToServer("http://localhost:4995/mcp");
 
-// Call a tool
 const result = await client.callTool("search-across-all-indexes", {
   q: "search kiosco antonio",
 });
+
+// Use AI inference to choose the most appropriate tool
+// First enable AI inference
+client.setUseAI(true);
+
+const result = await client.callToolWithAI("Find articles about cucumber");
+console.log(`Tool used: ${result.toolUsed}`);
+console.log(`Reasoning: ${result.reasoning}`);
+console.log(`Results: ${JSON.stringify(result.data)}`);
+```
+
+#### AI Inference Client Methods
+
+- `setUseAI(use: boolean)`: Enable or disable AI inference.
+- `callToolWithAI(query: string, specificTools?: string[])`: Process a user query with AI inference, optionally limiting to specific tools.
+
+### Starting the Server
+
+You can start the server programmatically:
+
+```typescript
+import mcpMeilisearchServer from "mcp-meilisearch";
+
+await mcpMeilisearchServer({
+  meilisearchHost: "http://localhost:7700",
+  meilisearchApiKey: "your_meilisearch_api_key",
+  providerApiKey: "your_ai_provider_api_key", // Required for AI inference
+  llmModel: "gpt-4", // Optional, defaults to gpt-3.5-turbo
+});
 ```
 
 ## Tools

package/dist/client.d.ts

@@ -1,4 +1,9 @@
 export declare class MCPClient {
+    /**
+     * Flag to enable/disable AI inference
+     * When enabled, user queries are processed by an AI to determine which tool to use
+     */
+    useAI: boolean;
     /**
      * Indicates whether the client is connected to the MCP server
      * Used to track the connection state and control async operations
@@ -11,12 +16,18 @@ export declare class MCPClient {
     tools: {
         name: string;
         description: string;
+        parameters: Record<string, any>;
     }[];
     private client;
     private tries;
     private transport;
     private toolsUpdatedCallback;
     constructor(serverName: string);
+    /**
+     * Set whether to use AI inference for tool selection
+     * @param use Whether to use AI inference
+     */
+    setUseAI(use: boolean): void;
     /**
      * Registers a callback to be called when the list of available tools changes
      * @param callback The function to call when tools are updated
@@ -52,6 +63,19 @@ export declare class MCPClient {
         data?: any;
         error?: string;
     }>;
+    /**
+     * 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
+     * @returns The result of calling the selected tool, or an error
+     */
+    callToolWithAI(query: string, specificTools?: string[]): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+        toolUsed?: string;
+        reasoning?: string;
+    }>;
     private setUpTransport;
     /**
      * Closes the connection to the server and resets the connection state

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;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAM;IAEpD,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;YAsBzC,SAAS;IAuBvB,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,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,KAAK,EAAE,OAAO,CAAS;IAEvB;;;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,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAI5B;;;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;IAwBvB,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"}

package/dist/client.js

@@ -1,7 +1,12 @@
+import { TextContentSchema, LoggingMessageNotificationSchema, ToolListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
 import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { TextContentSchema, LoggingMessageNotificationSchema, ToolListChangedNotificationSchema, } from "@modelcontextprotocol/sdk/types.js";
 export class MCPClient {
+    /**
+     * Flag to enable/disable AI inference
+     * When enabled, user queries are processed by an AI to determine which tool to use
+     */
+    useAI = false;
     /**
      * Indicates whether the client is connected to the MCP server
      * Used to track the connection state and control async operations
@@ -19,6 +24,13 @@ export class MCPClient {
     constructor(serverName) {
         this.client = new Client({ name: serverName, version: "1.0.0" });
     }
+    /**
+     * Set whether to use AI inference for tool selection
+     * @param use Whether to use AI inference
+     */
+    setUseAI(use) {
+        this.useAI = use;
+    }
     /**
      * Registers a callback to be called when the list of available tools changes
      * @param callback The function to call when tools are updated
@@ -53,11 +65,11 @@ export class MCPClient {
             await this.listTools();
             this.isConnected = true;
         }
-        catch (e) {
+        catch (error) {
             this.tries++;
             if (this.tries > 5) {
                 this.isConnected = false;
-                throw e;
+                throw error;
             }
             await new Promise((resolve) => setTimeout(resolve, this.tries * 1000));
             await this.connectToServer(serverUrl);
@@ -73,6 +85,7 @@ export class MCPClient {
                 this.tools = toolsResult.tools.map((tool) => ({
                     name: tool.name,
                     description: tool.description ?? "",
+                    parameters: tool.parameters || {},
                 }));
             }
             else {
@@ -137,6 +150,42 @@ export class MCPClient {
             return { success: false, error: errorMessage };
         }
     }
+    /**
+     * 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
+     * @returns The result of calling the selected tool, or an error
+     */
+    async callToolWithAI(query, specificTools) {
+        try {
+            const result = await this.callTool("process-ai-query", {
+                query,
+                specificTools,
+            });
+            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",
+                };
+            }
+            const toolResult = await this.callTool(toolName, parameters);
+            return {
+                ...toolResult,
+                reasoning,
+                toolUsed: toolName,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: `AI inference error: ${errorMessage}`,
+            };
+        }
+    }
     setUpTransport() {
         if (this.transport == null)
             return;

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;AAG7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,aAGR,GACA,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CA8GtB;AAkCD,eAAe,oBAAoB,CAAC"}
+{"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"}

package/dist/index.js

@@ -1,19 +1,37 @@
 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",
+};
 /**
  * Start a MCP server
  * @param options Configuration options for the MCP server
  * @returns A promise that resolves to the HTTP server instance
  */
-export async function mcpMeilisearchServer(options = {
-    meilisearchApiKey: "",
-    meilisearchHost: "http://localhost:7700",
-}) {
+export async function mcpMeilisearchServer(options = defaultOptions) {
+    configHandler.setLlmModel(options.llmModel);
+    configHandler.setAiProviderName(options.aiProviderName);
     configHandler.setMeilisearchHost(options.meilisearchHost);
+    configHandler.setAiProviderApiKey(options.aiProviderApiKey);
     configHandler.setMeilisearchApiKey(options.meilisearchApiKey);
+    const aiService = AIService.getInstance();
+    const apiKey = configHandler.getAiProviderApiKey();
+    if (apiKey) {
+        const llmModel = configHandler.getLlmModel();
+        const aiProviderName = configHandler.getAiProviderName();
+        aiService.initialize(apiKey, aiProviderName, llmModel);
+    }
+    else {
+        console.warn("AI provider API key not found. AI will not be available");
+    }
     const httpPort = options.httpPort || 4995;
     const transport = options.transport || "http";
     let mcpServerInstance = null;
@@ -73,14 +91,13 @@ export async function mcpMeilisearchServer(options = {
     });
     await new Promise((resolve) => {
         server.listen(httpPort, () => {
-            console.log(`MCP server listening on port ${httpPort}`);
+            console.info(`MCP server listening on port ${httpPort}`);
             resolve();
         });
     });
     try {
         const serverInstances = await initServer(transport, options);
         mcpServerInstance = serverInstances.mcpServer;
-        console.log("MCP server initialized successfully");
     }
     catch (error) {
         console.error("Failed to initialize MCP server:", error);
@@ -88,7 +105,7 @@ export async function mcpMeilisearchServer(options = {
         throw error;
     }
     const shutdownHandler = () => {
-        console.log("Shutting down MCP server...");
+        console.info("Shutting down MCP server...");
         if (mcpServerInstance && typeof mcpServerInstance.shutdown === "function") {
             try {
                 mcpServerInstance.shutdown();
@@ -105,10 +122,7 @@ export async function mcpMeilisearchServer(options = {
 }
 if (import.meta.url === `file://${process.argv?.[1]}`) {
     const args = process.argv.slice(2);
-    const options = {
-        meilisearchHost: "http://localhost:7700",
-        meilisearchApiKey: "",
-    };
+    const options = defaultOptions;
     for (let i = 0; i < args.length; i += 2) {
         const key = args[i].replace("--", "");
         const value = args[i + 1];
@@ -125,10 +139,18 @@ if (import.meta.url === `file://${process.argv?.[1]}`) {
             case "apiKey":
                 options.meilisearchApiKey = value;
                 break;
+            case "aiApiKey":
+                options.aiProviderApiKey = value;
+            case "aiProvider":
+                options.aiProviderName = value;
+                break;
+            case "llmModel":
+                options.llmModel = value;
+                break;
         }
     }
     mcpMeilisearchServer(options)
-        .then(() => console.log("MCP server running"))
+        .then(() => console.info("MCP server running"))
         .catch((err) => {
         console.error("Failed to start server:", err);
         process.exit(1);

package/dist/prompts/general.d.ts

@@ -0,0 +1,3 @@
+declare const _default: "\n\t\tAnswer the user's request using the relevant tool(s), if they are available. Check that all the required parameters for each tool call are provided or can reasonably be inferred from context. IF there are no relevant tools or there are missing values for required parameters, ask the user to supply these values; otherwise proceed with the tool calls. If the user provides a specific value for a parameter (for example provided in quotes), make sure to use that value EXACTLY. DO NOT make up values for or ask about optional parameters. Carefully analyze descriptive terms in the request as they may indicate required parameter values that should be included even if not explicitly quoted.\n\n\t\t<identity>\n\t\tYou are an AI programming assistant.\n\t\tWhen asked for your name, you must respond with \"Pati\".\n\t\tFollow the user's requirements carefully & to the letter.\n\t\tIf you are asked to generate content that is harmful, hateful, racist, sexist, lewd, violent, or completely irrelevant to software engineering, only respond with \"Sorry, I can't assist with that.\"\n\t\tKeep your answers short and impersonal.\n\t\t</identity>\n\n\t\t<instructions>\n\t\tYou are a highly sophisticated automated coding agent with expert-level knowledge across many different programming languages and frameworks.\n\t\tThe user will ask a question, or ask you to perform a task, and it may require lots of research to answer correctly. There is a selection of tools that let you perform actions or retrieve helpful context to answer the user's question.\n\t\tIf you can infer the project type (languages, frameworks, and libraries) from the user's query or the context that you have, make sure to keep them in mind when making changes.\n\t\tIf the user wants you to implement a feature and they have not specified the files to edit, first break down the user's request into smaller concepts and think about the kinds of files you need to grasp each concept.\n\t\tIf you aren't sure which tool is relevant, you can call multiple tools. You can call tools repeatedly to take actions or gather as much context as needed until you have completed the task fully. Don't give up unless you are sure the request cannot be fulfilled with the tools you have. It's YOUR RESPONSIBILITY to make sure that you have done all you can to collect necessary context.\n\t\tPrefer using the semantic_search tool to search for context unless you know the exact string or filename pattern you're searching for.\n\t\tDon't make assumptions about the situation- gather context first, then perform the task or answer the question.\n\t\tThink creatively and explore the workspace in order to make a complete fix.\n\t\tDon't repeat yourself after a tool call, pick up where you left off.\n\t\tNEVER print out a codeblock with file changes unless the user asked for it. Use the insert_edit_into_file tool instead.\n\t\tNEVER print out a codeblock with a terminal command to run unless the user asked for it. Use the run_in_terminal tool instead.\n\t\tYou don't need to read a file if it's already provided in context.\n\t\t</instructions>\n\n\t\t<toolUseInstructions>\n\t\tWhen using a tool, follow the json schema very carefully and make sure to include ALL required properties.\n\t\tAlways output valid JSON when using a tool.\n\t\tIf a tool exists to do a task, use the tool instead of asking the user to manually take an action.\n\t\tIf you say that you will take an action, then go ahead and use the tool to do it. No need to ask permission.\n\t\tNever use multi_tool_use.parallel or any tool that does not exist. Use tools using the proper procedure, DO NOT write out a json codeblock with the tool inputs.\n\t\tNever say the name of a tool to a user. For example, instead of saying that you'll use the run_in_terminal tool, say \"I'll run the command in a terminal\".\n\t\tIf you think running multiple tools can answer the user's question, prefer calling them in parallel whenever possible, but do not call semantic_search in parallel.\n\t\tIf semantic_search returns the full contents of the text files in the workspace, you have all the workspace context.\n\t\tDon't call the run_in_terminal tool multiple times in parallel. Instead, run one command and wait for the output before running the next command.\n\t\tAfter you have performed the user's task, if the user corrected something you did, expressed a coding preference, or communicated a fact that you need to remember, use the update_user_preferences tool to save their preferences.\n\t\t</toolUseInstructions>\n\n\t\t<editFileInstructions>\n\t\tDon't try to edit an existing file without reading it first, so you can make changes properly.\n\t\tUse the insert_edit_into_file tool to edit files. When editing files, group your changes by file.\n\t\tNEVER show the changes to the user, just call the tool, and the edits will be applied and shown to the user.\n\t\tNEVER print a codeblock that represents a change to a file, use insert_edit_into_file instead.\n\t\tFor each file, give a short description of what needs to be changed, then use the insert_edit_into_file tool. You can use any tool multiple times in a response, and you can keep writing text after using a tool.\n\t\tFollow best practices when editing files. If a popular external library exists to solve a problem, use it and properly install the package e.g. with \"npm install\" or creating a \"requirements.txt\".\n\t\tAfter editing a file, you MUST call get_errors to validate the change. Fix the errors if they are relevant to your change or the prompt, and remember to validate that they were actually fixed.\n\t\tThe insert_edit_into_file tool is very smart and can understand how to apply your edits to the user's files, you just need to provide minimal hints.\n\t\tWhen you use the insert_edit_into_file tool, avoid repeating existing code, instead use comments to represent regions of unchanged code. The tool prefers that you are as concise as possible. For example:\n\t\t// ...existing code...\n\t\tchanged code\n\t\t// ...existing code...\n\t\tchanged code\n\t\t// ...existing code...\n\n\t\tHere is an example of how you should format an edit to an existing Person class:\n\t\tclass Person {\n\t\t\t// ...existing code...\n\t\t\tage: number;\n\t\t\t// ...existing code...\n\t\t\tgetAge() {\n\t\t\t\treturn this.age;\n\t\t\t}\n\t\t}\n\t\t</editFileInstructions>\n\n\t\t<functions>\n\t\tMCP_TOOLS\n\t\t</functions>\n\n\t\t<context>\n\t\tMy current OS is: Linux\n\t\tI am working in a workspace that has the following structure:\n\t\t```\n\t\texample.txt\n\t\traw_complete_instructions.txt\n\t\traw_instructions.txt\n\t\t```\n\t\tThis view of the workspace structure may be truncated. You can use tools to collect more context if needed.\n\t\t</context>\n\n\t\t<reminder>\n\t\tWhen using the insert_edit_into_file tool, avoid repeating existing code, instead use a line comment with `...existing code...` to represent regions of unchanged code.\n\t\t</reminder>\n\n\t\t<tool_format>\n\t\t<function_calls>\n\t\t<invoke name=\"[tool_name]\">\n\t\t<parameter name=\"[param_name]\">[param_value]\n\t\t";
+export default _default;
+//# sourceMappingURL=general.d.ts.map

package/dist/prompts/general.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"general.d.ts","sourceRoot":"","sources":["../../src/prompts/general.ts"],"names":[],"mappings":";AAAA,wBAyFI"}

package/dist/prompts/general.js

@@ -0,0 +1,90 @@
+export default `
+		Answer the user's request using the relevant tool(s), if they are available. Check that all the required parameters for each tool call are provided or can reasonably be inferred from context. IF there are no relevant tools or there are missing values for required parameters, ask the user to supply these values; otherwise proceed with the tool calls. If the user provides a specific value for a parameter (for example provided in quotes), make sure to use that value EXACTLY. DO NOT make up values for or ask about optional parameters. Carefully analyze descriptive terms in the request as they may indicate required parameter values that should be included even if not explicitly quoted.
+
+		<identity>
+		You are an AI programming assistant.
+		When asked for your name, you must respond with "Pati".
+		Follow the user's requirements carefully & to the letter.
+		If you are asked to generate content that is harmful, hateful, racist, sexist, lewd, violent, or completely irrelevant to software engineering, only respond with "Sorry, I can't assist with that."
+		Keep your answers short and impersonal.
+		</identity>
+
+		<instructions>
+		You are a highly sophisticated automated coding agent with expert-level knowledge across many different programming languages and frameworks.
+		The user will ask a question, or ask you to perform a task, and it may require lots of research to answer correctly. There is a selection of tools that let you perform actions or retrieve helpful context to answer the user's question.
+		If you can infer the project type (languages, frameworks, and libraries) from the user's query or the context that you have, make sure to keep them in mind when making changes.
+		If the user wants you to implement a feature and they have not specified the files to edit, first break down the user's request into smaller concepts and think about the kinds of files you need to grasp each concept.
+		If you aren't sure which tool is relevant, you can call multiple tools. You can call tools repeatedly to take actions or gather as much context as needed until you have completed the task fully. Don't give up unless you are sure the request cannot be fulfilled with the tools you have. It's YOUR RESPONSIBILITY to make sure that you have done all you can to collect necessary context.
+		Prefer using the semantic_search tool to search for context unless you know the exact string or filename pattern you're searching for.
+		Don't make assumptions about the situation- gather context first, then perform the task or answer the question.
+		Think creatively and explore the workspace in order to make a complete fix.
+		Don't repeat yourself after a tool call, pick up where you left off.
+		NEVER print out a codeblock with file changes unless the user asked for it. Use the insert_edit_into_file tool instead.
+		NEVER print out a codeblock with a terminal command to run unless the user asked for it. Use the run_in_terminal tool instead.
+		You don't need to read a file if it's already provided in context.
+		</instructions>
+
+		<toolUseInstructions>
+		When using a tool, follow the json schema very carefully and make sure to include ALL required properties.
+		Always output valid JSON when using a tool.
+		If a tool exists to do a task, use the tool instead of asking the user to manually take an action.
+		If you say that you will take an action, then go ahead and use the tool to do it. No need to ask permission.
+		Never use multi_tool_use.parallel or any tool that does not exist. Use tools using the proper procedure, DO NOT write out a json codeblock with the tool inputs.
+		Never say the name of a tool to a user. For example, instead of saying that you'll use the run_in_terminal tool, say "I'll run the command in a terminal".
+		If you think running multiple tools can answer the user's question, prefer calling them in parallel whenever possible, but do not call semantic_search in parallel.
+		If semantic_search returns the full contents of the text files in the workspace, you have all the workspace context.
+		Don't call the run_in_terminal tool multiple times in parallel. Instead, run one command and wait for the output before running the next command.
+		After you have performed the user's task, if the user corrected something you did, expressed a coding preference, or communicated a fact that you need to remember, use the update_user_preferences tool to save their preferences.
+		</toolUseInstructions>
+
+		<editFileInstructions>
+		Don't try to edit an existing file without reading it first, so you can make changes properly.
+		Use the insert_edit_into_file tool to edit files. When editing files, group your changes by file.
+		NEVER show the changes to the user, just call the tool, and the edits will be applied and shown to the user.
+		NEVER print a codeblock that represents a change to a file, use insert_edit_into_file instead.
+		For each file, give a short description of what needs to be changed, then use the insert_edit_into_file tool. You can use any tool multiple times in a response, and you can keep writing text after using a tool.
+		Follow best practices when editing files. If a popular external library exists to solve a problem, use it and properly install the package e.g. with "npm install" or creating a "requirements.txt".
+		After editing a file, you MUST call get_errors to validate the change. Fix the errors if they are relevant to your change or the prompt, and remember to validate that they were actually fixed.
+		The insert_edit_into_file tool is very smart and can understand how to apply your edits to the user's files, you just need to provide minimal hints.
+		When you use the insert_edit_into_file tool, avoid repeating existing code, instead use comments to represent regions of unchanged code. The tool prefers that you are as concise as possible. For example:
+		// ...existing code...
+		changed code
+		// ...existing code...
+		changed code
+		// ...existing code...
+
+		Here is an example of how you should format an edit to an existing Person class:
+		class Person {
+			// ...existing code...
+			age: number;
+			// ...existing code...
+			getAge() {
+				return this.age;
+			}
+		}
+		</editFileInstructions>
+
+		<functions>
+		MCP_TOOLS
+		</functions>
+
+		<context>
+		My current OS is: Linux
+		I am working in a workspace that has the following structure:
+		\`\`\`
+		example.txt
+		raw_complete_instructions.txt
+		raw_instructions.txt
+		\`\`\`
+		This view of the workspace structure may be truncated. You can use tools to collect more context if needed.
+		</context>
+
+		<reminder>
+		When using the insert_edit_into_file tool, avoid repeating existing code, instead use a line comment with \`...existing code...\` to represent regions of unchanged code.
+		</reminder>
+
+		<tool_format>
+		<function_calls>
+		<invoke name="[tool_name]">
+		<parameter name="[param_name]">[param_value]
+		`;

package/dist/server.d.ts

@@ -4,6 +4,8 @@ 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;

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;AAevD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE;;GAEG;AACH,UAAU,YAAY;IACpB,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;AAiBD;;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;IAwCrC;;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;AAsED;;;;;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;AAgBvD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIpE;;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"}

package/dist/server.js

@@ -1,5 +1,6 @@
 import { randomUUID } from "node:crypto";
 import { InitializeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import registerAITools from "./tools/ai-tools.js";
 import registerTaskTools from "./tools/task-tools.js";
 import registerIndexTools from "./tools/index-tools.js";
 import registerSearchTools from "./tools/search-tools.js";
@@ -11,11 +12,13 @@ import { createErrorResponse } from "./utils/error-handler.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
-const DEFAULT_CONFIG = {
+const defaultConfig = {
     httpPort: 4995,
     mcpEndpoint: "/mcp",
     sessionTimeout: 3600000,
     sessionCleanupInterval: 60000,
+    apiKey: process.env.MEILISEARCH_API_KEY || "",
+    host: process.env.MEILISEARCH_HOST || "http://localhost:7700",
 };
 /**
  * Implementation of an MCP server for Meilisearch
@@ -34,7 +37,7 @@ export class MCPServer {
      */
     constructor(server, config = {}) {
         this.server = server;
-        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.config = { ...defaultConfig, ...config };
         this.startSessionCleanup();
     }
     /**
@@ -43,14 +46,14 @@ export class MCPServer {
      * @param res The HTTP response
      */
     async handleGetRequest(req, res) {
-        console.log("GET request received");
+        console.info("GET request received");
         const sessionId = this.extractSessionId(req);
         if (!sessionId || !this.sessions.has(sessionId)) {
             console.error(`Invalid session ID: ${sessionId}`);
             this.sendErrorResponse(res, 400, "Bad Request: invalid session ID");
             return;
         }
-        console.log(`Establishing HTTP stream for session ${sessionId}`);
+        console.info(`Establishing HTTP stream for session ${sessionId}`);
         const sessionInfo = this.sessions.get(sessionId);
         const transport = sessionInfo.transport;
         try {
@@ -76,7 +79,7 @@ export class MCPServer {
         const sessionId = this.extractSessionId(req);
         try {
             if (sessionId && this.sessions.has(sessionId)) {
-                console.log(`POST request for existing session ${sessionId}`);
+                console.info(`POST request for existing session ${sessionId}`);
                 const sessionInfo = this.sessions.get(sessionId);
                 await sessionInfo.transport.handleRequest(req, res, body);
                 this.updateSessionActivity(sessionId);
@@ -98,14 +101,14 @@ export class MCPServer {
      * Clean up and release server resources
      */
     shutdown() {
-        console.log("Shutting down MCP server...");
+        console.info("Shutting down MCP server...");
         if (this.cleanupInterval) {
             clearInterval(this.cleanupInterval);
             this.cleanupInterval = null;
         }
         for (const [sessionId, sessionInfo] of this.sessions.entries()) {
             try {
-                console.log(`Closing session ${sessionId}`);
+                console.info(`Closing session ${sessionId}`);
                 sessionInfo.transport.close();
             }
             catch (error) {
@@ -113,7 +116,7 @@ export class MCPServer {
             }
         }
         this.sessions.clear();
-        console.log("MCP server shutdown complete");
+        console.info("MCP server shutdown complete");
     }
     /**
      * Handles the initial connection request
@@ -122,7 +125,6 @@ export class MCPServer {
      * @param body The request body
      */
     async handleInitializeRequest(req, res, body) {
-        console.log("Handling initialize request");
         const newSessionId = randomUUID();
         const transport = new StreamableHTTPServerTransport({
             sessionIdGenerator: () => newSessionId,
@@ -138,7 +140,7 @@ export class MCPServer {
                 lastActivity: Date.now(),
             });
             this.sendToolListChangedNotification(transport);
-            console.log(`New session established: ${newSessionId}`);
+            console.info(`New session established: ${newSessionId}`);
         }
         catch (error) {
             console.error("Error handling initialize request:", error);
@@ -166,7 +168,7 @@ export class MCPServer {
                 jsonrpc: this.JSON_RPC,
             };
             await transport.send(rpcNotification);
-            console.log(`Sent notification: ${notification.method}`);
+            console.info(`Sent notification: ${notification.method}`);
         }
         catch (error) {
             console.error(`Failed to send notification ${notification.method}:`, error);
@@ -229,7 +231,7 @@ export class MCPServer {
             }
         }
         if (expiredIds.length) {
-            console.log(`Cleaning up ${expiredIds.length} expired sessions`);
+            console.info(`Cleaning up ${expiredIds.length} expired sessions`);
             for (const sessionId of expiredIds) {
                 try {
                     const info = this.sessions.get(sessionId);
@@ -249,10 +251,6 @@ export class MCPServer {
  * Initialize the MCP server with HTTP transport using Vite
  */
 const initServerHTTPTransport = async (customConfig) => {
-    const config = {
-        ...DEFAULT_CONFIG,
-        ...customConfig,
-    };
     const serverInstance = new McpServer({
         version: "1.0.0",
         name: "mcp-meilisearch",
@@ -264,19 +262,15 @@ const initServerHTTPTransport = async (customConfig) => {
     registerVectorTools(serverInstance);
     registerSystemTools(serverInstance);
     registerTaskTools(serverInstance);
-    const server = new MCPServer(serverInstance, config);
+    registerAITools(serverInstance);
+    const server = new MCPServer(serverInstance, customConfig);
     return { mcpServer: server };
 };
 /**
  * Initialize the MCP server with stdio transport
  * @returns MCP server instance
  */
-const initServerStdioTransport = async () => {
-    const config = {
-        ...DEFAULT_CONFIG,
-        host: process.env.MEILISEARCH_HOST,
-        apiKey: process.env.MEILISEARCH_API_KEY,
-    };
+const initServerStdioTransport = async (customConfig) => {
     const serverInstance = new McpServer({
         version: "1.0.0",
         name: "mcp-meilisearch",
@@ -288,12 +282,13 @@ const initServerStdioTransport = async () => {
     registerVectorTools(serverInstance);
     registerSystemTools(serverInstance);
     registerTaskTools(serverInstance);
-    const server = new MCPServer(serverInstance, config);
+    registerAITools(serverInstance);
+    const server = new MCPServer(serverInstance, customConfig);
     const transport = new StdioServerTransport();
     await serverInstance.connect(transport);
-    console.log("Meilisearch MCP Server is running on stdio transport");
+    console.info("Meilisearch MCP Server is running on stdio transport");
     process.on("SIGINT", () => {
-        console.log("Shutting down stdio server...");
+        console.info("Shutting down stdio server...");
         process.exit(0);
     });
     return { mcpServer: server };
@@ -308,7 +303,7 @@ export const initServer = async (transport, config) => {
     try {
         switch (transport) {
             case "stdio":
-                return await initServerStdioTransport();
+                return await initServerStdioTransport(config);
             case "http":
                 return await initServerHTTPTransport(config);
             default:

package/dist/stdio.js

@@ -1,6 +1,5 @@
 import { mcpMeilisearchServer } from "./index.js";
 mcpMeilisearchServer({
     transport: "stdio",
-    meilisearchHost: process.env.VITE_MEILISEARCH_HOST,
-    meilisearchApiKey: process.env.VITE_MEILISEARCH_API_KEY,
+    meilisearchHost: process.env.MEILISEARCH_HOST,
 });

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

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Register AI tools with the MCP server
+ * @param server - The MCP server instance
+ */
+export declare const registerAITools: (server: McpServer) => void;
+export default registerAITools;
+//# sourceMappingURL=ai-tools.d.ts.map

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

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

package/dist/tools/ai-tools.js

@@ -0,0 +1,66 @@
+import { z } from "zod";
+import { AIService } from "../utils/ai-handler.js";
+import { createErrorResponse } from "../utils/error-handler.js";
+/**
+ * Register AI tools with the MCP server
+ * @param server - The MCP server instance
+ */
+export const registerAITools = (server) => {
+    server.tool("process-ai-query", "Process a natural language query using AI to determine which tool to use", {
+        query: z.string().describe("The natural language query to process"),
+        specificTools: z
+            .array(z.string())
+            .optional()
+            .describe("Optional array of specific tool names to consider"),
+    }, async ({ query, specificTools }) => {
+        try {
+            const aiService = AIService.getInstance();
+            const availableTools = Object.entries(server._registeredTools)
+                .filter(([name]) => name !== "process-ai-query")
+                .map(([name, { description }]) => ({
+                name,
+                description,
+                parameters: {},
+            }));
+            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.",
+                        },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            toolName: result.toolName,
+                            parameters: result.parameters,
+                            reasoning: result.reasoning || "No explanation provided",
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return createErrorResponse(error);
+        }
+    });
+};
+export default registerAITools;

package/dist/tools/search-tools.js

@@ -147,7 +147,7 @@ export const registerSearchTools = (server) => {
                 params: { limit: 1000 },
             });
             const indexUids = indexesResponse.data.results.map((index) => index.uid);
-            if (!indexUids || indexUids.length === 0) {
+            if (!indexUids?.length) {
                 return {
                     content: [
                         {

package/dist/types/options.d.ts

@@ -1,15 +1,14 @@
+export type AiProviderNameOptions = "openai" | "huggingface" | "anthropic";
 export interface ServerOptions {
     /**
      * The URL of the Meilisearch instance
-     * @required
-     * @example "http://localhost:7700"
+     * @default "http://localhost:7700"
      */
-    meilisearchHost: string;
+    meilisearchHost?: string;
     /**
      * The API key for authenticating with Meilisearch
-     * @required
      */
-    meilisearchApiKey: string;
+    meilisearchApiKey?: string;
     /**
      * Transport type for MCP server ("http" | "stdio")
      * @default "http"
@@ -35,5 +34,19 @@ export interface ServerOptions {
      * @default 60000 (1 minute)
      */
     sessionCleanupInterval?: number;
+    /**
+     * AI inference provider name
+     * @default "openai"
+     */
+    aiProviderName?: AiProviderNameOptions;
+    /**
+     * AI provider API key for AI inference
+     */
+    aiProviderApiKey?: string;
+    /**
+     * AI model to use for inference
+     * @default "gpt-3.5-turbo"
+     */
+    llmModel?: string;
 }
 //# sourceMappingURL=options.d.ts.map

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,WAAW,aAAa;IAC5B;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;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;CACjC"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,CAAC;AAE3E,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"}

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

@@ -0,0 +1,72 @@
+import { AiProviderNameOptions } from "../types/options.js";
+/**
+ * AI Inference Service
+ *
+ * This service handles the interaction with the AI to determine the appropriate tools
+ * to use based on the user's query
+ */
+export declare class AIService {
+    private model;
+    private systemPrompt;
+    private static instance;
+    private static serverInitialized;
+    private provider;
+    private client;
+    private availableTools;
+    /**
+     * Private constructor to prevent direct instantiation
+     * Use getInstance() method instead
+     */
+    private constructor();
+    /**
+     * Get the singleton instance of AIService
+     * @returns The singleton AIService instance
+     */
+    static getInstance(): AIService;
+    /**
+     * Initialize the AI service with an API key and optionally set the model
+     * This should ONLY be called from the server side
+     * @param apiKey AI provider API key (required)
+     * @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;
+    /**
+     * Set the available tools that can be used by the AI
+     * @param tools Array of tools with name, description, and parameters
+     */
+    setAvailableTools(tools: {
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    }[]): void;
+    ensureInitialized(): boolean;
+    /**
+     * Get tool definitions for the AI from the available tools
+     * @param toolNames Optional array of tool names to filter by (if not provided, all tools will be included)
+     * @returns Array of tool definitions
+     */
+    private getToolDefinitions;
+    /**
+     * Attempt to extract specific tool names from the user query
+     * @param query The user's query
+     * @returns Array of tool names mentioned in the query, or empty array if none found
+     */
+    private extractToolNames;
+    /**
+     * Process a user query and determine which tool to use
+     * @param query User query
+     * @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<{
+        toolName: string;
+        parameters: Record<string, any>;
+        reasoning?: string;
+    } | null>;
+    private processHuggingFaceQuery;
+    private processAnthropicQuery;
+    private processOpenAIQuery;
+    private setSystemPrompt;
+}
+//# sourceMappingURL=ai-handler.d.ts.map

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

@@ -0,0 +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;AAsB5D;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,MAAM,CAAqD;IACnE,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,CACf,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KACjC,EAAE,GACF,IAAI;IAUP,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC;QACT,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAChC,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;YAgCK,uBAAuB;YA2BvB,qBAAqB;YAmCrB,kBAAkB;IA2BhC,OAAO,CAAC,eAAe;CAGxB"}

package/dist/utils/ai-handler.js

@@ -0,0 +1,218 @@
+import { OpenAI } from "openai";
+import Anthropic from "@anthropic-ai/sdk";
+import generalPrompt from "../prompts/general.js";
+import { InferenceClient } from "@huggingface/inference";
+/**
+ * AI Inference Service
+ *
+ * This service handles the interaction with the AI to determine the appropriate tools
+ * to use based on the user's query
+ */
+export class AIService {
+    model = "gpt-3.5-turbo";
+    systemPrompt = generalPrompt;
+    static instance = null;
+    static serverInitialized = false;
+    provider = "openai";
+    client = null;
+    availableTools = [];
+    /**
+     * Private constructor to prevent direct instantiation
+     * Use getInstance() method instead
+     */
+    constructor() { }
+    /**
+     * Get the singleton instance of AIService
+     * @returns The singleton AIService instance
+     */
+    static getInstance() {
+        if (!AIService.instance) {
+            AIService.instance = new AIService();
+        }
+        return AIService.instance;
+    }
+    /**
+     * Initialize the AI service with an API key and optionally set the model
+     * This should ONLY be called from the server side
+     * @param apiKey AI provider API key (required)
+     * @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) {
+            console.warn("AIService has already been initialized by the server.");
+            return;
+        }
+        this.provider = provider;
+        if (model)
+            this.model = model;
+        switch (this.provider) {
+            case "openai":
+                this.client = new OpenAI({ apiKey });
+                break;
+            case "anthropic":
+                this.client = new Anthropic({ apiKey });
+                break;
+            case "huggingface":
+                this.client = new InferenceClient(apiKey);
+                break;
+            default:
+                throw new Error(`Unsupported AI provider: ${this.provider}`);
+        }
+        AIService.serverInitialized = true;
+    }
+    /**
+     * Set the available tools that can be used by the AI
+     * @param tools Array of tools with name, description, and parameters
+     */
+    setAvailableTools(tools) {
+        this.availableTools = tools;
+        this.setSystemPrompt(this.systemPrompt.replace("MCP_TOOLS", JSON.stringify(this.availableTools, null, 2)));
+    }
+    ensureInitialized() {
+        return this.client !== null;
+    }
+    /**
+     * Get tool definitions for the AI from the available tools
+     * @param toolNames Optional array of tool names to filter by (if not provided, all tools will be included)
+     * @returns Array of tool definitions
+     */
+    getToolDefinitions(toolNames) {
+        if (!toolNames?.length) {
+            return this.availableTools.map((tool) => ({
+                type: "function",
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.parameters,
+                },
+            }));
+        }
+        return this.availableTools
+            .filter((tool) => toolNames.includes(tool.name))
+            .map((tool) => ({
+            type: "function",
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.parameters,
+            },
+        }));
+    }
+    /**
+     * Attempt to extract specific tool names from the user query
+     * @param query The user's query
+     * @returns Array of tool names mentioned in the query, or empty array if none found
+     */
+    extractToolNames(query) {
+        const mentionedTools = [];
+        for (const tool of this.availableTools) {
+            const toolNameRegex = new RegExp(`\\b${tool.name}\\b`, "i");
+            if (toolNameRegex.test(query)) {
+                mentionedTools.push(tool.name);
+            }
+        }
+        return mentionedTools;
+    }
+    /**
+     * Process a user query and determine which tool to use
+     * @param query User query
+     * @param specificTools Optional array of specific tool names to consider
+     * @returns Object containing the selected tool name and parameters
+     */
+    async processQuery(query, specificTools) {
+        if (!this.ensureInitialized())
+            return null;
+        try {
+            const mentionedTools = this.extractToolNames(query);
+            const toolsToUse = specificTools || (mentionedTools.length ? mentionedTools : undefined);
+            const tools = this.getToolDefinitions(toolsToUse);
+            const messages = [
+                { role: "system", content: this.systemPrompt },
+                { role: "user", content: query },
+            ];
+            if (this.provider === "openai") {
+                return this.processOpenAIQuery(tools, messages);
+            }
+            if (this.provider === "anthropic") {
+                return this.processAnthropicQuery(tools, messages);
+            }
+            if (this.provider === "huggingface") {
+                return this.processHuggingFaceQuery(tools, messages);
+            }
+            return null;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(error.message);
+            }
+            throw error;
+        }
+    }
+    async processHuggingFaceQuery(tools, messages) {
+        const response = await this.client.chatCompletion({
+            tools,
+            messages,
+            max_tokens: 512,
+            model: this.model,
+        });
+        if (!response.choices?.length)
+            return null;
+        const message = response.choices[0].message;
+        if (message.tool_calls?.length) {
+            const toolCall = message.tool_calls[0];
+            return {
+                toolName: toolCall.function.name,
+                reasoning: message.content || undefined,
+                parameters: JSON.parse(toolCall.function.arguments),
+            };
+        }
+        return null;
+    }
+    async processAnthropicQuery(tools, messages) {
+        const response = await this.client.messages.create({
+            tools,
+            messages,
+            max_tokens: 1024,
+            model: this.model,
+        });
+        const content = response.content;
+        if (Array.isArray(content) && content.length) {
+            const toolCallItem = content.find((item) => item.type === "tool_call");
+            if (toolCallItem?.tool_call) {
+                const textItems = content.filter((item) => item.type === "text" &&
+                    content.indexOf(item) < content.indexOf(toolCallItem));
+                const reasoning = textItems.map((item) => item.text).join(" ");
+                return {
+                    reasoning: reasoning || undefined,
+                    toolName: toolCallItem.tool_call.name,
+                    parameters: JSON.parse(toolCallItem.tool_call.input),
+                };
+            }
+        }
+        return null;
+    }
+    async processOpenAIQuery(tools, messages) {
+        const response = await this.client.chat.completions.create({
+            model: this.model,
+            messages,
+            tools,
+            tool_choice: "auto",
+        });
+        if (!response.choices?.length)
+            return null;
+        const message = response.choices[0].message;
+        if (message.tool_calls?.length) {
+            const toolCall = message.tool_calls[0];
+            return {
+                toolName: toolCall.function.name,
+                reasoning: message.content || undefined,
+                parameters: JSON.parse(toolCall.function.arguments),
+            };
+        }
+        return null;
+    }
+    setSystemPrompt(prompt) {
+        this.systemPrompt = prompt;
+    }
+}

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

@@ -1,19 +1,23 @@
+import { AiProviderNameOptions } from "../types/options.js";
 /**
  * Configuration service to store and retrieve Meilisearch configuration
  */
 declare class ConfigHandler {
+    private _llmModel;
+    private _aiProviderName;
     private _meilisearchHost;
+    private _aiProviderApiKey;
     private _meilisearchApiKey;
     /**
      * Set the Meilisearch host URL
      * @param host The URL of the Meilisearch instance
      */
-    setMeilisearchHost(host: string): void;
+    setMeilisearchHost(host?: string): void;
     /**
      * Set the Meilisearch API key
      * @param apiKey The API key for Meilisearch
      */
-    setMeilisearchApiKey(apiKey: string): void;
+    setMeilisearchApiKey(apiKey?: string): void;
     /**
      * Get the current Meilisearch host URL
      * @returns The URL of the Meilisearch instance
@@ -24,6 +28,36 @@ declare class ConfigHandler {
      * @returns The API key for Meilisearch
      */
     getMeilisearchApiKey(): string;
+    /**
+     * Set the provider for AI inference
+     * @param provider The provider name: openai, huggingface.
+     */
+    setAiProviderName(provider?: AiProviderNameOptions): void;
+    /**
+     * Get the current provider for AI inference
+     * @returns The provider name
+     */
+    getAiProviderName(): AiProviderNameOptions;
+    /**
+     * Set the provider API key
+     * @param apiKey The API key for provider
+     */
+    setAiProviderApiKey(apiKey?: string): void;
+    /**
+     * Get the current provider API key
+     * @returns The API key for provider
+     */
+    getAiProviderApiKey(): string;
+    /**
+     * Set the AI model to use
+     * @param model The model name (e.g., gpt-3.5-turbo, gpt-4)
+     */
+    setLlmModel(model?: string): void;
+    /**
+     * Get the current AI model
+     * @returns The model name
+     */
+    getLlmModel(): string;
 }
 export declare const configHandler: ConfigHandler;
 export default configHandler;

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

@@ -1 +1 @@
-{"version":3,"file":"config-handler.d.ts","sourceRoot":"","sources":["../../src/utils/config-handler.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,kBAAkB,CAAM;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAItC;;;OAGG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI1C;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;OAGG;IACH,oBAAoB,IAAI,MAAM;CAG/B;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"config-handler.d.ts","sourceRoot":"","sources":["../../src/utils/config-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;GAEG;AACH,cAAM,aAAa;IACjB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,eAAe,CAAM;IAC7B,OAAO,CAAC,gBAAgB,CAAM;IAC9B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,kBAAkB,CAAM;IAEhC;;;OAGG;IACH,kBAAkB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIvC;;;OAGG;IACH,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;OAGG;IACH,oBAAoB,IAAI,MAAM;IAI9B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,CAAC,EAAE,qBAAqB,GAAG,IAAI;IAIzD;;;OAGG;IACH,iBAAiB,IACgB,qBAAqB;IAGtD;;;OAGG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI1C;;;OAGG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;;OAGG;IACH,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAIjC;;;OAGG;IACH,WAAW,IAAI,MAAM;CAGtB;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC;AAEjD,eAAe,aAAa,CAAC"}

package/dist/utils/config-handler.js

@@ -2,14 +2,17 @@
  * Configuration service to store and retrieve Meilisearch configuration
  */
 class ConfigHandler {
+    _llmModel = "";
+    _aiProviderName = "";
     _meilisearchHost = "";
+    _aiProviderApiKey = "";
     _meilisearchApiKey = "";
     /**
      * Set the Meilisearch host URL
      * @param host The URL of the Meilisearch instance
      */
     setMeilisearchHost(host) {
-        this._meilisearchHost = host;
+        this._meilisearchHost = host || "http://localhost:7700";
     }
     /**
      * Set the Meilisearch API key
@@ -32,6 +35,48 @@ class ConfigHandler {
     getMeilisearchApiKey() {
         return this._meilisearchApiKey;
     }
+    /**
+     * Set the provider for AI inference
+     * @param provider The provider name: openai, huggingface.
+     */
+    setAiProviderName(provider) {
+        this._aiProviderName = provider || "openai";
+    }
+    /**
+     * Get the current provider for AI inference
+     * @returns The provider name
+     */
+    getAiProviderName() {
+        return this._aiProviderName;
+    }
+    /**
+     * Set the provider API key
+     * @param apiKey The API key for provider
+     */
+    setAiProviderApiKey(apiKey) {
+        this._aiProviderApiKey = apiKey || "";
+    }
+    /**
+     * Get the current provider API key
+     * @returns The API key for provider
+     */
+    getAiProviderApiKey() {
+        return this._aiProviderApiKey;
+    }
+    /**
+     * Set the AI model to use
+     * @param model The model name (e.g., gpt-3.5-turbo, gpt-4)
+     */
+    setLlmModel(model) {
+        this._llmModel = model || "gpt-3.5-turbo";
+    }
+    /**
+     * Get the current AI model
+     * @returns The model name
+     */
+    getLlmModel() {
+        return this._llmModel;
+    }
 }
 export const configHandler = new ConfigHandler();
 export default configHandler;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meilisearch",
-  "version": "1.2.8",
+  "version": "1.3.1",
   "description": "Model Context Protocol (MCP) implementation for Meilisearch",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -23,14 +23,17 @@
     "demo"
   ],
   "scripts": {
-    "build": "tsc && tsc --project tsconfig.types.json",
+    "build": "tsc && tsc -p tsconfig.types.json",
     "demo": "npm run build & npm run dev --workspace=demo",
     "server": "npm run build && node --env-file=.env dist/index.js",
     "prepublishOnly": "rm -rf dist && npm version patch && npm run build"
   },
   "dependencies": {
+    "@anthropic-ai/sdk": "^0.50.4",
+    "@huggingface/inference": "^3.13.0",
     "@modelcontextprotocol/sdk": "^1.11.2",
     "axios": "^1.9.0",
+    "openai": "^4.98.0",
     "zod": "^3.24.4"
   },
   "devDependencies": {