Meilisearch MCP Server

Features

• Index and document management

• Settings configuration and management

• Task monitoring and API key management

• Built-in logging and monitoring tools

• Dynamic connection configuration to switch between Meilisearch instances

• Smart search across single or multiple indices

• This is a Python implementation, there is Typescript integration if you need to work with a Meilisearch MCP server within the browser

Installation

Requirements

• Python 3.9

• Running Meilisearch instance

• Node.js (for testing with MCP Inspector)

Usage

Environment Variables

Dynamic Connection Configuration

• get-connection-settings: View current connection URL and API key status

• update-connection-settings: Update URL and/or API key to connect to a different Meilisearch instance

Search Functionality

• search: Search through Meilisearch indices with optional parameters

• query: The search query (required)

• indexUid: Specific index to search in (optional)

• limit: Maximum number of results per index (optional, default: 20)

• offset: Number of results to skip (optional, default: 0)

• filter: Filter expression (optional)

• sort: Sorting rules (optional)

Running the Server

Usage with Claude Desktop

Testing with MCP Inspector

Available Tools

Connection Management

• get-connection-settings: View current Meilisearch connection URL and API key status

• update-connection-settings: Update URL and/or API key to connect to a different instance

Index Management

• create-index: Create a new index with optional primary key

• list-indexes: List all available indexes

• get-index-metrics: Get detailed metrics for a specific index

Document Operations

• get-documents: Retrieve documents from an index with pagination

• add-documents: Add or update documents in an index

Search

• search: Flexible search across single or multiple indices with filtering and sorting options

Settings Management

• get-settings: View current settings for an index

• update-settings: Update index settings (ranking, faceting, etc.)

API Key Management

• get-keys: List all API keys

• create-key: Create new API key with specific permissions

• delete-key: Delete an existing API key

Task Management

• get-task: Get information about a specific task

• get-tasks: List tasks with optional filters:

• cancel-tasks: Cancel pending or enqueued tasks

• delete-tasks: Delete completed tasks

System Monitoring

• health-check: Basic health check

• get-health-status: Comprehensive health status

• get-version: Get Meilisearch version information

• get-stats: Get database statistics

• get-system-info: Get system-level information

Contributing

1. Fork repository

2. Create feature branch

3. Commit changes

4. Create pull request

License

Meilisearch MCP Server

Features

• Index and document management

• Settings configuration and management

• Task monitoring and API key management

• Built-in logging and monitoring tools

• Dynamic connection configuration to switch between Meilisearch instances

• Smart search across single or multiple indices

• This is a Python implementation, there is Typescript integration if you need to work with a Meilisearch MCP server within the browser

Installation

Requirements

• Python 3.9

• Running Meilisearch instance

• Node.js (for testing with MCP Inspector)

Usage

Environment Variables

Dynamic Connection Configuration

• get-connection-settings: View current connection URL and API key status

• update-connection-settings: Update URL and/or API key to connect to a different Meilisearch instance

Search Functionality

• search: Search through Meilisearch indices with optional parameters

• query: The search query (required)

• indexUid: Specific index to search in (optional)

• limit: Maximum number of results per index (optional, default: 20)

• offset: Number of results to skip (optional, default: 0)

• filter: Filter expression (optional)

• sort: Sorting rules (optional)

Running the Server

Usage with Claude Desktop

Testing with MCP Inspector

Available Tools

Connection Management

• get-connection-settings: View current Meilisearch connection URL and API key status

• update-connection-settings: Update URL and/or API key to connect to a different instance

Index Management

• create-index: Create a new index with optional primary key

• list-indexes: List all available indexes

• get-index-metrics: Get detailed metrics for a specific index

Document Operations

• get-documents: Retrieve documents from an index with pagination

• add-documents: Add or update documents in an index

Search

• search: Flexible search across single or multiple indices with filtering and sorting options

Settings Management

• get-settings: View current settings for an index

• update-settings: Update index settings (ranking, faceting, etc.)

API Key Management

• get-keys: List all API keys

• create-key: Create new API key with specific permissions

• delete-key: Delete an existing API key

Task Management

• get-task: Get information about a specific task

• get-tasks: List tasks with optional filters:

• cancel-tasks: Cancel pending or enqueued tasks

• delete-tasks: Delete completed tasks

System Monitoring

• health-check: Basic health check

• get-health-status: Comprehensive health status

• get-version: Get Meilisearch version information

• get-stats: Get database statistics

• get-system-info: Get system-level information

Contributing

1. Fork repository

2. Create feature branch

3. Commit changes

4. Create pull request

License