This server provides a Model Context Protocol (MCP) interface for Meilisearch, enabling seamless integration with LLM tools like Claude. You can:
- Manage Connections: View and update Meilisearch URL/API key settings
- Search Functionality: Perform flexible searches across indices with filtering, sorting, limiting, and offset
- Index Management: Create, list, and retrieve metrics for indices
- Document Operations: Add, retrieve, and manage documents
- Settings Management: View and update index settings like ranking and faceting
- API Key Management: Create, list, and delete API keys with specific permissions
- Task Management: Monitor, cancel, and delete tasks with detailed filtering options
- System Monitoring: Check health, view version information, and get database statistics
Provides a Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces, supporting index and document management, settings configuration, task monitoring, API key management, and search capabilities across single or multiple indices.
Meilisearch MCP Server
A Model Context Protocol (MCP) server for interacting with Meilisearch through LLM interfaces like Claude.
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
The server provides tools to view and update connection settings at runtime:
get-connection-settings
: View current connection URL and API key statusupdate-connection-settings
: Update URL and/or API key to connect to a different Meilisearch instance
Example usage through MCP:
Search Functionality
The server provides a flexible search tool that can search across one or all indices:
search
: Search through Meilisearch indices with optional parameters
Example usage through MCP:
Available search 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
To use this with Claude Desktop, add the following to your claude_desktop_config.json
:
Testing with MCP Inspector
Available Tools
Connection Management
get-connection-settings
: View current Meilisearch connection URL and API key statusupdate-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 keylist-indexes
: List all available indexesget-index-metrics
: Get detailed metrics for a specific index
Document Operations
get-documents
: Retrieve documents from an index with paginationadd-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 indexupdate-settings
: Update index settings (ranking, faceting, etc.)
API Key Management
get-keys
: List all API keyscreate-key
: Create new API key with specific permissionsdelete-key
: Delete an existing API key
Task Management
get-task
: Get information about a specific taskget-tasks
: List tasks with optional filters:limit
: Maximum number of tasks to returnfrom
: Number of tasks to skipreverse
: Sort order of tasksbatchUids
: Filter by batch UIDsuids
: Filter by task UIDscanceledBy
: Filter by cancellation sourcetypes
: Filter by task typesstatuses
: Filter by task statusesindexUids
: Filter by index UIDsafterEnqueuedAt
/beforeEnqueuedAt
: Filter by enqueue timeafterStartedAt
/beforeStartedAt
: Filter by start timeafterFinishedAt
/beforeFinishedAt
: Filter by finish time
cancel-tasks
: Cancel pending or enqueued tasksdelete-tasks
: Delete completed tasks
System Monitoring
health-check
: Basic health checkget-health-status
: Comprehensive health statusget-version
: Get Meilisearch version informationget-stats
: Get database statisticsget-system-info
: Get system-level information
Contributing
- Fork repository
- Create feature branch
- Commit changes
- Create pull request
License
MIT
You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Server for interacting with Meilisearch through LLM interfaces like Claude.
Related MCP Servers
- -securityFlicense-qualityAn MCP server that allows Claude to interact with local LLMs running in LM Studio, providing access to list models, generate text, and use chat completions through local models.Last updated -Python
- -securityFlicense-qualityAn MCP server that integrates with Claude to provide smart documentation search capabilities across multiple AI/ML libraries, allowing users to retrieve and process technical information through natural language queries.Last updated -Python
- -securityAlicense-qualityAn open-source MCP server that provides applications like Cursor, Windsurf, and Claude with access to llms.txt documentation files, allowing users to control and audit context retrieval.Last updated -4PythonMIT License
- -security-license-qualityA server that enables Claude to search and access documentation from popular libraries like LangChain, LlamaIndex, and OpenAI directly within conversations.Last updated -1Python