mcp-meilisearch 1.0.15 → 1.0.17

package/README.md

@@ -101,3 +101,19 @@ This project uses:
 
 - `sessionTimeout`: Session timeout in milliseconds (Default: 3600000)
 - `sessionCleanupInterval`: Session cleanup interval in milliseconds (Default: 60000)
+
+### Using the MCPClient
+
+The package also 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:3000/mcp");
+
+// Call a tool
+const result = await client.callTool("search-across-all-indexes", {
+  q: "search kiosco antonio",
+});
+```

package/dist/client.d.ts

@@ -0,0 +1,26 @@
+export declare class MCPClient {
+    tools: {
+        name: string;
+        description: string;
+    }[];
+    private client;
+    private tries;
+    private transport;
+    private onToolsUpdatedCallback;
+    constructor(serverName: string);
+    setOnToolsUpdatedCallback(callback: (tools: Array<{
+        name: string;
+        description: string;
+    }>) => void): void;
+    connectToServer(serverUrl: string): Promise<void>;
+    listTools(): Promise<void>;
+    private setUpNotifications;
+    callTool(name: string, args?: Record<string, any>): Promise<{
+        success: boolean;
+        data?: any;
+        error?: string;
+    }>;
+    private setUpTransport;
+    cleanup(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,qBAAa,SAAS;IACpB,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,sBAAsB,CAEd;gBAEJ,UAAU,EAAE,MAAM;IAIvB,yBAAyB,CAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,KAAK,IAAI;IAKnE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAuBhC,OAAO,CAAC,kBAAkB;IAWpB,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;IAoCF,OAAO,CAAC,cAAc;IAKhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/client.js

@@ -0,0 +1,103 @@
+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 {
+    tools = [];
+    client;
+    tries = 0;
+    transport = null;
+    onToolsUpdatedCallback = null;
+    constructor(serverName) {
+        this.client = new Client({ name: serverName, version: "1.0.0" });
+    }
+    setOnToolsUpdatedCallback(callback) {
+        this.onToolsUpdatedCallback = callback;
+    }
+    async connectToServer(serverUrl) {
+        const url = new URL(serverUrl);
+        try {
+            this.transport = new StreamableHTTPClientTransport(url);
+            await this.client.connect(this.transport);
+            this.setUpTransport();
+            this.setUpNotifications();
+            await this.listTools();
+        }
+        catch (e) {
+            this.tries++;
+            if (this.tries > 5) {
+                throw e;
+            }
+            await new Promise((resolve) => setTimeout(resolve, this.tries * 1000));
+            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.map((tool) => ({
+                    name: tool.name,
+                    description: tool.description ?? "",
+                }));
+            }
+            else {
+                this.tools = [];
+            }
+        }
+        catch (error) {
+            this.tools = [];
+        }
+        finally {
+            if (this.onToolsUpdatedCallback) {
+                this.onToolsUpdatedCallback([...this.tools]);
+            }
+        }
+    }
+    setUpNotifications() {
+        this.client.setNotificationHandler(LoggingMessageNotificationSchema, console.info);
+        this.client.setNotificationHandler(ToolListChangedNotificationSchema, this.listTools);
+    }
+    async callTool(name, args) {
+        try {
+            const result = await this.client.callTool({ name, arguments: args });
+            if (!result) {
+                return {
+                    success: false,
+                    error: "Received null or undefined result from tool",
+                };
+            }
+            const content = result.content;
+            if (!content?.length) {
+                return { success: true, data: [] };
+            }
+            const processedContent = content.reduce((_, item) => {
+                const parse = TextContentSchema.safeParse(item);
+                if (parse.success) {
+                    try {
+                        return JSON.parse(parse.data.text);
+                    }
+                    catch (e) {
+                        return parse.data.text;
+                    }
+                }
+                return item;
+            }, {});
+            return { success: true, data: processedContent };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { success: false, error: errorMessage };
+        }
+    }
+    setUpTransport() {
+        if (this.transport === null)
+            return;
+        this.transport.onerror = this.cleanup;
+    }
+    async cleanup() {
+        await this.client.close();
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meilisearch",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Model Context Protocol (MCP) implementation for Meilisearch",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,16 @@
     "dist",
     "README.md"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "import": "./dist/client.js",
+      "types": "./dist/client.d.ts"
+    }
+  },
   "workspaces": [
     "demo"
   ],