Meilisearch MCP Server

Instructions

Implementation Reference

• src/tools/index-tools.ts:99-111 (handler)

  The core handler function that executes the create-index tool logic: sends a POST request to Meilisearch /indexes endpoint with uid and optional primaryKey, returns JSON response or error.

  async ({ indexUid, primaryKey }: CreateIndexParams) => {
    try {
      const response = await apiClient.post('/indexes', {
        uid: indexUid,
        primaryKey,
      });
      return {
        content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
      };
    } catch (error) {
      return createErrorResponse(error);
    }
  }

• src/tools/index-tools.ts:95-98 (schema)

  Zod schema defining the input parameters for the create-index tool: indexUid (required string) and primaryKey (optional string).

  {
    indexUid: z.string().describe('Unique identifier for the new index'),
    primaryKey: z.string().optional().describe('Primary key for the index'),
  },

• src/tools/index-tools.ts:92-111 (registration)

  MCP tool registration for 'create-index': specifies name, description, input schema, and handler function.

  server.tool(
    'create-index',
    'Create a new Meilisearch index',
    {
      indexUid: z.string().describe('Unique identifier for the new index'),
      primaryKey: z.string().optional().describe('Primary key for the index'),
    },
    async ({ indexUid, primaryKey }: CreateIndexParams) => {
      try {
        const response = await apiClient.post('/indexes', {
          uid: indexUid,
          primaryKey,
        });
        return {
          content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }],
        };
      } catch (error) {
        return createErrorResponse(error);
      }
    }

• src/tools/index-tools.ts:23-26 (schema)

  TypeScript interface for CreateIndexParams used in the handler signature.

  interface CreateIndexParams {
    indexUid: string;
    primaryKey?: string;
  }

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

  Top-level call to register all index tools (including create-index) with the main MCP server instance.

  registerIndexTools(server);