mcp-meilisearch 1.4.7 → 1.4.9

package/README.md

@@ -354,18 +354,131 @@ The MCP server exposes various tools that allow you to interact with Meilisearch
 - **Parameters**:
   - `indexUid` (string, required): Unique identifier of the index.
 
-#### get-searchable-attributes / get-displayed-attributes / get-filterable-attributes / get-sortable-attributes / get-ranking-rules / get-stop-words / get-synonyms / get-distinct-attribute / get-typo-tolerance / get-faceting / get-pagination
+#### Get Settings Tools
+
+The following tools retrieve specific settings for a Meilisearch index:
+
+- **get-displayed-attributes**
+- **get-searchable-attributes**
+- **get-filterable-attributes**
+- **get-sortable-attributes**
+- **get-ranking-rules**
+- **get-stop-words**
+- **get-synonyms**
+- **get-typo-tolerance**
+- **get-pagination**
+- **get-faceting**
+- **get-dictionary**
+- **get-proximity-precision**
+- **get-separator-tokens**
+- **get-non-separator-tokens**
+- **get-word-dictionary**
+
+All these tools have the same parameter:
+
+- `indexUid` (string, required): Unique identifier of the index.
+
+#### Update Settings Tools
+
+The following tools update specific settings for a Meilisearch index:
+
+- **update-displayed-attributes**
 
-- **Description**: Get the specific setting for an index.
-- **Parameters**:
   - `indexUid` (string, required): Unique identifier of the index.
+  - `displayedAttributes` (string, required): JSON array of attributes to display, e.g. ["title", "description"].
 
-#### update-searchable-attributes / update-displayed-attributes / update-filterable-attributes / update-sortable-attributes / update-ranking-rules / update-stop-words / update-synonyms / update-distinct-attribute / update-typo-tolerance / update-faceting / update-pagination
+- **update-searchable-attributes**
 
-- **Description**: Update a specific setting for an index.
-- **Parameters**:
   - `indexUid` (string, required): Unique identifier of the index.
-  - `value` (string, required): JSON value for the setting.
+  - `searchableAttributes` (string, required): JSON array of attributes that can be searched, e.g. ["title", "description"].
+
+- **update-filterable-attributes**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `filterableAttributes` (string, required): JSON array of attributes that can be used as filters, e.g. ["genre", "director"].
+
+- **update-sortable-attributes**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `sortableAttributes` (string, required): JSON array of attributes that can be used for sorting, e.g. ["price", "date"].
+
+- **update-ranking-rules**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `rankingRules` (string, required): JSON array of ranking rules, e.g. ["typo", "words", "proximity", "attribute", "sort", "exactness"].
+
+- **update-stop-words**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `stopWords` (string, required): JSON array of words to ignore in search queries, e.g. ["the", "a", "an"].
+
+- **update-synonyms**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `synonyms` (string, required): JSON object mapping words to their synonyms, e.g. {"movie": ["film"]}.
+
+- **update-typo-tolerance**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `typoTolerance` (string, required): JSON object with typo tolerance configuration, e.g. {"enabled": true, "minWordSizeForTypos": {"oneTypo": 5, "twoTypos": 9}}.
+
+- **update-pagination**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `pagination` (string, required): JSON object with pagination configuration, e.g. {"maxTotalHits": 1000}.
+
+- **update-faceting**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `faceting` (string, required): JSON object with faceting configuration, e.g. {"maxValuesPerFacet": 100}.
+
+- **update-dictionary**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `dictionary` (string, required): JSON array of words to consider as a single word, e.g. ["San Francisco", "New York"].
+
+- **update-proximity-precision**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `proximityPrecision` (string, required): String with proximity precision value, can be 'byWord' or 'byAttribute'.
+
+- **update-separator-tokens**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `separatorTokens` (string, required): JSON array of tokens that should be considered as word separators, e.g. ["-", "_"].
+
+- **update-non-separator-tokens**
+
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `nonSeparatorTokens` (string, required): JSON array of tokens that should not be considered as word separators, e.g. ["@", "."].
+
+- **update-word-dictionary**
+  - `indexUid` (string, required): Unique identifier of the index.
+  - `wordDictionary` (string, required): JSON array of custom words to add to the dictionary, e.g. ["cbuilder", "meilisearch"].
+
+#### Reset Settings Tools
+
+The following tools reset specific settings for a Meilisearch index to their default values:
+
+- **reset-displayed-attributes**
+- **reset-searchable-attributes**
+- **reset-filterable-attributes**
+- **reset-sortable-attributes**
+- **reset-ranking-rules**
+- **reset-stop-words**
+- **reset-synonyms**
+- **reset-typo-tolerance**
+- **reset-pagination**
+- **reset-faceting**
+- **reset-dictionary**
+- **reset-proximity-precision**
+- **reset-separator-tokens**
+- **reset-non-separator-tokens**
+- **reset-word-dictionary**
+
+All these reset tools have the same parameter:
+
+- `indexUid` (string, required): Unique identifier of the index.
 
 ### Task Tools
 

package/dist/index.js

@@ -21,7 +21,7 @@ export async function mcpMeilisearchServer(options = defaultOptions) {
         aiService.initialize(apiKey, aiProviderName, llmModel);
     }
     else {
-        console.warn("AI provider API key not found. AI will not be available");
+        console.warn("AI provider API key not found. Continuing without it.");
     }
     let mcpServerInstance = null;
     const transport = options.transport;

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 import { IncomingMessage, ServerResponse } from "http";
 import { ServerOptions } from "./types/options.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { McpServer as McpServerInstance } from "@modelcontextprotocol/sdk/server/mcp.js";
 /**
  * Return type for the initServer function
  */
@@ -21,8 +21,8 @@ export declare const defaultOptions: {
 export declare class MCPServer {
     private readonly JSON_RPC;
     private readonly SESSION_ID_HEADER_NAME;
-    private server;
     private config;
+    private server;
     private cleanupInterval;
     private sessions;
     /**
@@ -30,7 +30,7 @@ export declare class MCPServer {
      * @param server The underlying MCP server implementation
      * @param config Configuration options
      */
-    constructor(server: McpServer, config?: Partial<ServerOptions>);
+    constructor(server: McpServerInstance, config?: Partial<ServerOptions>);
     /**
      * Handles an HTTP request and routes it to the appropriate handler
      * @param req The HTTP request

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;AAOvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAUpE;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,SAAS,CAAC;CACtB;AASD,eAAO,MAAM,cAAc;;;;;;;CAO1B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoB;IAE3D,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;OAIG;gBACS,MAAM,EAAE,SAAS,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAOlE;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,WAAW,GAAE,MAAmC,GAC/C,OAAO,CAAC,IAAI,CAAC;IA+ChB;;;;OAIG;IACG,gBAAgB,CACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;OAKG;YACW,uBAAuB;IAuCrC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA2B/B;AA+DD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,YAAW,MAAM,GAAG,OAAgB,EACpC,SAAS,OAAO,CAAC,aAAa,CAAC,KAC9B,OAAO,CAAC,cAAc,CAcxB,CAAC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAOvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAWnD,OAAO,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAGzF;;GAEG;AACH,UAAU,cAAc;IACtB,SAAS,EAAE,SAAS,CAAC;CACtB;AASD,eAAO,MAAM,cAAc;;;;;;;CAO1B,CAAC;AAEF;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAoB;IAE3D,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;;;OAIG;gBACS,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAO1E;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,WAAW,GAAE,MAAmC,GAC/C,OAAO,CAAC,IAAI,CAAC;IA+ChB;;;;OAIG;IACG,gBAAgB,CACpB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC;IA+BhB;;;;;OAKG;IACG,iBAAiB,CACrB,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,IAAI,CAAC;IA+BhB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAqBhB;;;;;OAKG;YACW,uBAAuB;IAuCrC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CA2B/B;AAyDD;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,GACrB,YAAW,MAAM,GAAG,OAAgB,EACpC,SAAS,OAAO,CAAC,aAAa,CAAC,KAC9B,OAAO,CAAC,cAAc,CAcxB,CAAC"}

package/dist/server.js

@@ -3,7 +3,6 @@ import { InitializeRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import registerAITools from "./tools/core/ai-tools.js";
 import { createErrorResponse } from "./utils/error-handler.js";
 import registerTaskTools from "./tools/meilisearch/task-tools.js";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import registerIndexTools from "./tools/meilisearch/index-tools.js";
 import registerSearchTools from "./tools/meilisearch/search-tools.js";
 import registerSystemTools from "./tools/meilisearch/system-tools.js";
@@ -11,6 +10,7 @@ import registerVectorTools from "./tools/meilisearch/vector-tools.js";
 import registerDocumentTools from "./tools/meilisearch/document-tools.js";
 import registerSettingsTools from "./tools/meilisearch/settings-tools.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { McpServer as McpServerInstance } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 export const defaultOptions = {
     httpPort: 4995,
@@ -26,8 +26,8 @@ export const defaultOptions = {
 export class MCPServer {
     JSON_RPC = "2.0";
     SESSION_ID_HEADER_NAME = "mcp-session-id";
-    server;
     config;
+    server;
     cleanupInterval = null;
     sessions = new Map();
     /**
@@ -293,10 +293,11 @@ export class MCPServer {
     }
 }
 /**
- * Initialize the MCP server with HTTP transport
+ * Create a new MCP server instance
+ * @returns MCP server instance
  */
-const initServerHTTPTransport = async (customConfig) => {
-    const serverInstance = new McpServer({
+const createServerInstance = () => {
+    const serverInstance = new McpServerInstance({
         version: "1.0.0",
         name: "mcp-meilisearch",
     });
@@ -308,6 +309,13 @@ const initServerHTTPTransport = async (customConfig) => {
     registerSystemTools(serverInstance);
     registerTaskTools(serverInstance);
     registerAITools(serverInstance);
+    return serverInstance;
+};
+/**
+ * Initialize the MCP server with HTTP transport
+ */
+const initServerHTTPTransport = async (customConfig) => {
+    const serverInstance = createServerInstance();
     const server = new MCPServer(serverInstance, customConfig);
     return { mcpServer: server };
 };
@@ -316,22 +324,10 @@ const initServerHTTPTransport = async (customConfig) => {
  * @returns MCP server instance
  */
 const initServerStdioTransport = async (customConfig) => {
-    const serverInstance = new McpServer({
-        version: "1.0.0",
-        name: "mcp-meilisearch",
-    });
-    registerIndexTools(serverInstance);
-    registerDocumentTools(serverInstance);
-    registerSearchTools(serverInstance);
-    registerSettingsTools(serverInstance);
-    registerVectorTools(serverInstance);
-    registerSystemTools(serverInstance);
-    registerTaskTools(serverInstance);
-    registerAITools(serverInstance);
+    const serverInstance = createServerInstance();
     const server = new MCPServer(serverInstance, customConfig);
     const transport = new StdioServerTransport();
     await serverInstance.connect(transport);
-    console.info("Meilisearch MCP Server is running on stdio transport");
     process.on("SIGINT", () => {
         console.info("Shutting down stdio server...");
         process.exit(0);

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

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

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

@@ -1,8 +1,8 @@
 import { z } from "zod";
 import { zodToJsonSchema } from "zod-to-json-schema";
 import { AIService } from "../../utils/ai-handler.js";
-import { cleanNullValues } from "../../utils/response-handler.js";
 import { createErrorResponse } from "../../utils/error-handler.js";
+import { convertNullToUndefined } from "../../utils/response-handler.js";
 /**
  * Register AI tools with the MCP server
  * @param server - The MCP server instance
@@ -17,7 +17,8 @@ export const registerAITools = (server) => {
     }, { category: "core" }, async ({ query, specificTools }) => {
         try {
             const aiService = AIService.getInstance();
-            const availableTools = Object.entries(server._registeredTools)
+            const registeredTools = Object.entries(server._registeredTools);
+            const availableTools = registeredTools
                 .filter(([_, { annotations }]) => annotations?.category !== "core")
                 .map(([name, { description, inputSchema }]) => {
                 const { definitions } = zodToJsonSchema(inputSchema, "parameters");
@@ -28,17 +29,18 @@ export const registerAITools = (server) => {
                 };
             });
             aiService.setAvailableTools(availableTools);
-            const result = await aiService.processQuery(query, specificTools);
-            if (result.error)
-                return createErrorResponse(result.error);
+            const response = await aiService.processQuery(query, specificTools);
+            if (response.error)
+                return createErrorResponse(response.error);
             return {
+                isError: false,
                 content: [
                     {
                         type: "text",
                         text: JSON.stringify({
-                            toolName: result.toolName,
-                            reasoning: result.reasoning,
-                            parameters: cleanNullValues(result.parameters),
+                            toolName: response.toolName,
+                            reasoning: response.reasoning,
+                            parameters: convertNullToUndefined(response.parameters),
                         }, null, 2),
                     },
                 ],

package/dist/tools/meilisearch/settings-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/meilisearch/settings-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,SAgqCtD,CAAC;AAEF,eAAe,qBAAqB,CAAC"}
+{"version":3,"file":"settings-tools.d.ts","sourceRoot":"","sources":["../../../src/tools/meilisearch/settings-tools.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE;;;;GAIG;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,SA2uCtD,CAAC;AAEF,eAAe,qBAAqB,CAAC"}

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

@@ -93,6 +93,9 @@ export const registerSettingsTools = (server) => {
     // Update displayed attributes setting
     server.tool("update-displayed-attributes", "Update the displayed attributes setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        displayedAttributes: z
+            .string()
+            .describe('JSON array of attributes to display, e.g. ["title", "description"]'),
     }, { category: "meilisearch" }, async ({ indexUid, displayedAttributes }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/displayed-attributes`, displayedAttributes);
@@ -141,6 +144,9 @@ export const registerSettingsTools = (server) => {
     // Update filterable attributes setting
     server.tool("update-filterable-attributes", "Update the filterable attributes setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        filterableAttributes: z
+            .string()
+            .describe('JSON array of attributes that can be used as filters, e.g. ["genre", "director"]'),
     }, { category: "meilisearch" }, async ({ indexUid, filterableAttributes }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/filterable-attributes`, filterableAttributes);
@@ -189,6 +195,9 @@ export const registerSettingsTools = (server) => {
     // Update sortable attributes setting
     server.tool("update-sortable-attributes", "Update the sortable attributes setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        sortableAttributes: z
+            .string()
+            .describe('JSON array of attributes that can be used for sorting, e.g. ["price", "date"]'),
     }, { category: "meilisearch" }, async ({ indexUid, sortableAttributes }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/sortable-attributes`, sortableAttributes);
@@ -237,6 +246,9 @@ export const registerSettingsTools = (server) => {
     // Update searchable attributes setting
     server.tool("update-searchable-attributes", "Update the searchable attributes setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        searchableAttributes: z
+            .string()
+            .describe('JSON array of attributes that can be searched, e.g. ["title", "description"]'),
     }, { category: "meilisearch" }, async ({ indexUid, searchableAttributes }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/searchable-attributes`, searchableAttributes);
@@ -285,6 +297,9 @@ export const registerSettingsTools = (server) => {
     // Update ranking rules setting
     server.tool("update-ranking-rules", "Update the ranking rules setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        rankingRules: z
+            .string()
+            .describe('JSON array of ranking rules, e.g. ["typo", "words", "proximity", "attribute", "sort", "exactness"]'),
     }, { category: "meilisearch" }, async ({ indexUid, rankingRules }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/ranking-rules`, rankingRules);
@@ -333,6 +348,9 @@ export const registerSettingsTools = (server) => {
     // Update stop words setting
     server.tool("update-stop-words", "Update the stop words setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        stopWords: z
+            .string()
+            .describe('JSON array of words to ignore in search queries, e.g. ["the", "a", "an"]'),
     }, { category: "meilisearch" }, async ({ indexUid, stopWords }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/stop-words`, stopWords);
@@ -381,6 +399,9 @@ export const registerSettingsTools = (server) => {
     // Update synonyms setting
     server.tool("update-synonyms", "Update the synonyms setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        synonyms: z
+            .string()
+            .describe('JSON object mapping words to their synonyms, e.g. {"movie": ["film"]}'),
     }, { category: "meilisearch" }, async ({ indexUid, synonyms }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/synonyms`, synonyms);
@@ -429,6 +450,9 @@ export const registerSettingsTools = (server) => {
     // Update typo tolerance setting
     server.tool("update-typo-tolerance", "Update the typo tolerance setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        typoTolerance: z
+            .string()
+            .describe('JSON object with typo tolerance configuration, e.g. {"enabled": true, "minWordSizeForTypos": {"oneTypo": 5, "twoTypos": 9}}'),
     }, { category: "meilisearch" }, async ({ indexUid, typoTolerance }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/typo-tolerance`, typoTolerance);
@@ -477,6 +501,9 @@ export const registerSettingsTools = (server) => {
     // Update pagination setting
     server.tool("update-pagination", "Update the pagination setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        pagination: z
+            .string()
+            .describe('JSON object with pagination configuration, e.g. {"maxTotalHits": 1000}'),
     }, { category: "meilisearch" }, async ({ indexUid, pagination }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/pagination`, pagination);
@@ -525,6 +552,9 @@ export const registerSettingsTools = (server) => {
     // Update faceting setting
     server.tool("update-faceting", "Update the faceting setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        faceting: z
+            .string()
+            .describe('JSON object with faceting configuration, e.g. {"maxValuesPerFacet": 100}'),
     }, { category: "meilisearch" }, async ({ indexUid, faceting }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/faceting`, faceting);
@@ -573,6 +603,9 @@ export const registerSettingsTools = (server) => {
     // Update dictionary setting
     server.tool("update-dictionary", "Update the dictionary setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        dictionary: z
+            .string()
+            .describe('JSON array of words to consider as a single word, e.g. ["San Francisco", "New York"]'),
     }, { category: "meilisearch" }, async ({ indexUid, dictionary }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/dictionary`, dictionary);
@@ -621,6 +654,9 @@ export const registerSettingsTools = (server) => {
     // Update proximity precision setting
     server.tool("update-proximity-precision", "Update the proximity precision setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        proximityPrecision: z
+            .string()
+            .describe("String with proximity precision value, can be 'byWord' or 'byAttribute'"),
     }, { category: "meilisearch" }, async ({ indexUid, proximityPrecision }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/proximity-precision`, proximityPrecision);
@@ -669,6 +705,9 @@ export const registerSettingsTools = (server) => {
     // Update separator tokens setting
     server.tool("update-separator-tokens", "Update the separator tokens setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        separatorTokens: z
+            .string()
+            .describe('JSON array of tokens that should be considered as word separators, e.g. ["-", "_"]'),
     }, { category: "meilisearch" }, async ({ indexUid, separatorTokens }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/separator-tokens`, separatorTokens);
@@ -717,6 +756,9 @@ export const registerSettingsTools = (server) => {
     // Update non-separator tokens setting
     server.tool("update-non-separator-tokens", "Update the non-separator tokens setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        nonSeparatorTokens: z
+            .string()
+            .describe('JSON array of tokens that should not be considered as word separators, e.g. ["@", "."]'),
     }, { category: "meilisearch" }, async ({ indexUid, nonSeparatorTokens }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/non-separator-tokens`, nonSeparatorTokens);
@@ -765,6 +807,9 @@ export const registerSettingsTools = (server) => {
     // Update word dictionary setting
     server.tool("update-word-dictionary", "Update the word dictionary setting for a Meilisearch index", {
         indexUid: z.string().describe("Unique identifier of the index"),
+        wordDictionary: z
+            .string()
+            .describe('JSON array of custom words to add to the dictionary, e.g. ["cbuilder", "meilisearch"]'),
     }, { category: "meilisearch" }, async ({ indexUid, wordDictionary }) => {
         try {
             const response = await apiClient.put(`/indexes/${indexUid}/settings/word-dictionary`, wordDictionary);

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

@@ -5,9 +5,9 @@ interface AITool {
     parameters: Record<string, unknown>;
 }
 interface AIToolResponse {
+    error?: unknown;
     toolName?: string;
     reasoning?: string;
-    error: string | null;
     parameters?: Record<string, unknown>;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAmBD,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAyBP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,CAAC;YA4BZ,kBAAkB;YA+DlB,uBAAuB;CAyDtC"}
+{"version":3,"file":"ai-handler.d.ts","sourceRoot":"","sources":["../../src/utils/ai-handler.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,UAAU,MAAM;IACd,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAmBD,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0B;IACjD,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAgD;IAE9D;;;OAGG;IACH,OAAO;IAEP;;;OAGG;WACW,WAAW,IAAI,SAAS;IAOtC;;;;;;OAMG;IACH,UAAU,CACR,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,qBAAgC,EAC1C,KAAK,CAAC,EAAE,MAAM,GACb,IAAI;IAyBP;;;OAGG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,iBAAiB,IAAI,OAAO;IAI5B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;;;;OAKG;IACG,YAAY,CAChB,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,cAAc,CAAC;YA4BZ,kBAAkB;YA6DlB,uBAAuB;CAuDtC"}

package/dist/utils/ai-handler.js

@@ -154,7 +154,6 @@ export class AIService {
                     parameters: JSON.parse(toolCall.arguments),
                 };
                 return {
-                    error: null,
                     toolName: inferenceToolResponse.name,
                     parameters: inferenceToolResponse.parameters,
                     reasoning: JSON.stringify(inferenceToolResponse, null, 2),
@@ -168,7 +167,6 @@ export class AIService {
                     };
                 }
                 return {
-                    error: null,
                     toolName: toolCall.name,
                     parameters: toolCall.parameters,
                     reasoning: JSON.stringify(toolCall, null, 2),
@@ -177,7 +175,7 @@ export class AIService {
             return { error: "No tool call or content in OpenAI response" };
         }
         catch (error) {
-            return { error: `OpenAI API error: ${error}` };
+            return { error };
         }
     }
     async processHuggingFaceQuery(tools, messages) {
@@ -203,7 +201,6 @@ export class AIService {
                     parameters: JSON.parse(toolCall.arguments),
                 };
                 return {
-                    error: null,
                     toolName: inferenceToolResponse.name,
                     parameters: inferenceToolResponse.parameters,
                     reasoning: JSON.stringify(inferenceToolResponse, null, 2),
@@ -214,7 +211,6 @@ export class AIService {
                 if (!toolCall)
                     return { error: "Invalid tool call format in content" };
                 return {
-                    error: null,
                     toolName: toolCall.name,
                     parameters: toolCall.parameters,
                     reasoning: JSON.stringify(toolCall, null, 2),
@@ -223,7 +219,7 @@ export class AIService {
             return { error: "No tool call or content in Hugging Face response" };
         }
         catch (error) {
-            return { error: `Hugging Face API error: ${error}` };
+            return { error };
         }
     }
 }

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

@@ -14,7 +14,7 @@ export declare const handleApiError: (error: any) => string;
 export declare const createErrorResponse: (error: any) => {
     isError: boolean;
     content: {
-        type: string;
+        type: "text";
         text: string;
     }[];
 };
@@ -23,7 +23,7 @@ declare const _default: {
     createErrorResponse: (error: any) => {
         isError: boolean;
         content: {
-            type: string;
+            type: "text";
             text: string;
         }[];
     };

package/dist/utils/error-handler.js

@@ -12,7 +12,7 @@ export const handleApiError = (error) => {
         return `Meilisearch API error (${status}): ${JSON.stringify(data)}`;
     }
     // If it's a network error or other error
-    return `MCP Server error: ${JSON.stringify(error)}`;
+    return JSON.stringify(error);
 };
 /**
  * Creates a standardized error response object for MCP tools

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

@@ -11,5 +11,5 @@ export declare function markdownToJson<T>(markdownJsonString: string): T | null;
  * Recursively removes null values from an object, replacing them with undefined
  * This ensures optional parameters are properly handled by JSON schema validation
  */
-export declare function cleanNullValues(obj?: Record<string, any>): Record<string, any>;
+export declare function convertNullToUndefined(obj: unknown, seen?: WeakMap<object, unknown>): unknown;
 //# sourceMappingURL=response-handler.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/utils/response-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAoCtE;AAgCD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAwBrB"}
+{"version":3,"file":"response-handler.d.ts","sourceRoot":"","sources":["../../src/utils/response-handler.ts"],"names":[],"mappings":"AA0CA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAuDtE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,IAAI,GAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAiB,GAC7C,OAAO,CA6BT"}

package/dist/utils/response-handler.js

@@ -1,3 +1,41 @@
+function tryParseJsonString(str) {
+    if (typeof str === "string" &&
+        str.length >= 2 &&
+        ((str.startsWith("{") && str.endsWith("}")) ||
+            (str.startsWith("[") && str.endsWith("]")))) {
+        try {
+            return JSON.parse(str);
+        }
+        catch {
+            return str;
+        }
+    }
+    return str;
+}
+function parseNestedJsonStrings(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(parseNestedJsonStrings);
+    }
+    if (obj !== null && typeof obj === "object") {
+        const result = {};
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                result[key] = parseNestedJsonStrings(obj[key]);
+            }
+        }
+        return result;
+    }
+    if (typeof obj === "string") {
+        return tryParseJsonString(obj);
+    }
+    return obj;
+}
+const TRAILING_COMMA_REGEX = /,\s*([}\]])/g;
+const SINGLE_LINE_COMMENT_REGEX = /\/\/[^\r\n]*/g;
+const MULTI_LINE_COMMENT_REGEX = /\/\*[\s\S]*?\*\//g;
+const FENCE_REGEX = /^```(?:json)?\s*([\s\S]*?)\s*```$/;
+const JSON_TAG_REGEX = /<json>\s*([\s\S]*?)\s*<\/json>/;
+const UNQUOTED_KEYS_REGEX = /([{,]\s*)([a-zA-Z_][a-zA-Z0-9_]*)\s*:/g;
 /**
  * Transforms a string, potentially containing JSON embedded in Markdown
  * or with non-standard features like comments and trailing commas,
@@ -7,94 +45,87 @@
  * @returns A parsed JavaScript object/array, or null if parsing fails.
  */
 export function markdownToJson(markdownJsonString) {
-    if (typeof markdownJsonString !== "string" || !markdownJsonString.trim()) {
+    if (typeof markdownJsonString !== "string")
         return null;
-    }
-    let S = markdownJsonString.trim();
-    const fenceRegex = /^```(?:json)?\s*([\s\S]*?)\s*```$/;
-    const fenceMatch = S.match(fenceRegex);
-    if (fenceMatch && fenceMatch[1]) {
-        S = fenceMatch[1].trim();
+    let jsonString = markdownJsonString.trim();
+    if (!jsonString)
+        return null;
+    const fenceMatch = jsonString.match(FENCE_REGEX);
+    if (fenceMatch && fenceMatch[1] !== undefined) {
+        jsonString = fenceMatch[1].trim();
     }
     else {
-        const jsonTagRegex = /<json>\s*([\s\S]*?)\s*<\/json>/;
-        const jsonTagMatch = S.match(jsonTagRegex);
-        if (jsonTagMatch && jsonTagMatch[1]) {
-            S = jsonTagMatch[1].trim();
+        const jsonTagMatch = jsonString.match(JSON_TAG_REGEX);
+        if (jsonTagMatch && jsonTagMatch[1] !== undefined) {
+            jsonString = jsonTagMatch[1].trim();
         }
     }
-    if (S === "")
+    if (jsonString === "")
         return null;
-    S = S.replace(/\/\/[^\r\n]*/g, "");
-    S = S.replace(/\/\*[\s\S]*?\*\//g, "");
-    S = S.replace(/,\s*([}\]])/g, "$1");
-    S = S.replace(/([{,]\s*)([a-zA-Z_][a-zA-Z0-9_]*)\s*:/g, '$1"$2":');
+    let parsedJson;
+    try {
+        parsedJson = JSON.parse(jsonString);
+    }
+    catch {
+        let cleanedJson = jsonString;
+        cleanedJson = cleanedJson.replace(SINGLE_LINE_COMMENT_REGEX, "");
+        cleanedJson = cleanedJson.replace(MULTI_LINE_COMMENT_REGEX, "");
+        cleanedJson = cleanedJson.trim();
+        if (cleanedJson === "")
+            return null;
+        cleanedJson = cleanedJson.replace(TRAILING_COMMA_REGEX, "$1");
+        cleanedJson = cleanedJson.replace(UNQUOTED_KEYS_REGEX, '$1"$2":');
+        try {
+            parsedJson = JSON.parse(cleanedJson);
+        }
+        catch (error) {
+            console.error("Failed to parse JSON after transformations.");
+            console.error("Original string:", markdownJsonString);
+            console.error("String after extraction (before cleaning):", jsonString);
+            console.error("Processed string that failed parsing:", cleanedJson);
+            console.error("Error:", error);
+            return null;
+        }
+    }
     try {
-        const parsedJson = JSON.parse(S);
         return parseNestedJsonStrings(parsedJson);
     }
     catch (error) {
-        console.error("Failed to parse JSON after transformations.");
-        console.error("Original string:", markdownJsonString);
-        console.error("Processed string that failed:", S);
+        console.error("Error during nested JSON string parsing:");
+        console.error("Parsed object before nested parsing:", parsedJson);
         console.error("Error:", error);
         return null;
     }
 }
-function tryParseJsonString(str) {
-    try {
-        if (typeof str === "string" &&
-            ((str.startsWith("[") && str.endsWith("]")) ||
-                (str.startsWith("{") && str.endsWith("}")))) {
-            return JSON.parse(str);
-        }
-        return str;
-    }
-    catch {
-        return str;
-    }
-}
-function parseNestedJsonStrings(obj) {
-    if (Array.isArray(obj)) {
-        return obj.map((item) => parseNestedJsonStrings(item));
-    }
-    else if (obj !== null && typeof obj === "object") {
-        const result = {};
-        for (const key of Object.keys(obj)) {
-            result[key] = parseNestedJsonStrings(obj[key]);
-        }
-        return result;
-    }
-    else if (typeof obj === "string") {
-        return tryParseJsonString(obj);
-    }
-    return obj;
-}
 /**
  * Recursively removes null values from an object, replacing them with undefined
  * This ensures optional parameters are properly handled by JSON schema validation
  */
-export function cleanNullValues(obj) {
-    if (!obj || typeof obj !== "object")
-        return obj ?? {};
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (value === null) {
-            continue;
-        }
-        else if (typeof value === "object" && value !== null) {
-            if (Array.isArray(value)) {
-                result[key] = value.map((item) => typeof item === "object" && item !== null
-                    ? cleanNullValues(item)
-                    : item);
-            }
-            else {
-                result[key] = cleanNullValues(value);
-            }
-        }
-        else {
-            result[key] = value;
+export function convertNullToUndefined(obj, seen = new WeakMap()) {
+    if (obj === null)
+        return undefined;
+    if (obj === undefined || typeof obj !== "object")
+        return obj;
+    if (seen.has(obj))
+        return seen.get(obj);
+    if (obj instanceof Date)
+        return new Date(obj.getTime());
+    if (obj instanceof RegExp)
+        return new RegExp(obj.source, obj.flags);
+    if (Array.isArray(obj)) {
+        const result = [];
+        seen.set(obj, result);
+        for (const item of obj) {
+            result.push(convertNullToUndefined(item, seen));
         }
+        return result;
+    }
+    const result = {};
+    seen.set(obj, result);
+    const keys = Object.keys(obj);
+    for (const key of keys) {
+        const value = obj[key];
+        result[key] = convertNullToUndefined(value, seen);
     }
     return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-meilisearch",
-  "version": "1.4.7",
+  "version": "1.4.9",
   "description": "Model Context Protocol (MCP) implementation for Meilisearch",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,7 +33,7 @@
     "@modelcontextprotocol/sdk": "^1.11.4",
     "axios": "^1.9.0",
     "openai": "^4.100.0",
-    "zod": "^3.25.1"
+    "zod": "^3.25.7"
   },
   "devDependencies": {
     "@types/node": "^22.15.19",