Meilisearch MCP Server

Instructions

Implementation Reference

• src/tools/document-tools.ts:221-241 (handler)

  Handler function that parses the JSON string of document IDs, validates it's an array, and sends a POST request to Meilisearch's delete-batch endpoint.

  async ({ indexUid, documentIds }: DeleteDocumentsParams) => {
    try {
      // Parse the document IDs string to ensure it's valid JSON
      const parsedDocumentIds = JSON.parse(documentIds);
      
      // Ensure document IDs is an array
      if (!Array.isArray(parsedDocumentIds)) {
        return {
          isError: true,
          content: [{ type: 'text', text: 'Document IDs must be a JSON array' }],
        };
      }
      
      const response = await apiClient.post(`/indexes/${indexUid}/documents/delete-batch`, parsedDocumentIds);
      return {
        content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
      };
    } catch (error) {
      return createErrorResponse(error);
    }
  }

• src/tools/document-tools.ts:217-220 (schema)

  Zod input schema defining parameters: indexUid (string) and documentIds (string representing JSON array).

  {
    indexUid: z.string().describe('Unique identifier of the index'),
    documentIds: z.string().describe('JSON array of document IDs to delete'),
  },

• src/tools/document-tools.ts:214-242 (registration)

  MCP server.tool registration for 'delete-documents', including name, description, input schema, and inline handler function.

  server.tool(
    'delete-documents',
    'Delete multiple documents by their IDs from a Meilisearch index',
    {
      indexUid: z.string().describe('Unique identifier of the index'),
      documentIds: z.string().describe('JSON array of document IDs to delete'),
    },
    async ({ indexUid, documentIds }: DeleteDocumentsParams) => {
      try {
        // Parse the document IDs string to ensure it's valid JSON
        const parsedDocumentIds = JSON.parse(documentIds);
        
        // Ensure document IDs is an array
        if (!Array.isArray(parsedDocumentIds)) {
          return {
            isError: true,
            content: [{ type: 'text', text: 'Document IDs must be a JSON array' }],
          };
        }
        
        const response = await apiClient.post(`/indexes/${indexUid}/documents/delete-batch`, parsedDocumentIds);
        return {
          content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
        };
      } catch (error) {
        return createErrorResponse(error);
      }
    }
  );

• src/tools/document-tools.ts:45-48 (schema)

  TypeScript interface defining parameters for the delete-documents tool handler.

  interface DeleteDocumentsParams {
    indexUid: string;
    documentIds: string;
  }

• src/index.ts:65-65 (registration)

  Invocation of registerDocumentTools which registers the delete-documents tool among others.

  registerDocumentTools(server);