Meilisearch MCP

An MCP server for interacting with Meilisearch through LLM interfaces (such as Claude), providing index management, document operations, search functions, and system monitoring.

Search tools Developer tools #Search service #Index management #Document operation #System monitoring .Python

rating : 2.5 points

downloads : 89

update time : 2025-04-29

What is the Meilisearch MCP Server?

The Meilisearch MCP Server is a tool for managing Meilisearch instances. It supports operations such as creating, updating, and deleting indexes, managing documents, configuring settings, and monitoring tasks. It also allows users to dynamically switch connection configurations through natural language queries.

How to use the Meilisearch MCP Server?

First, you need to install and run the server. Then, specify the Meilisearch instance address and API key through the configuration file. Next, you can use the built - in command - line tools or API to perform various operations, such as searching, index management, and task monitoring.

Applicable scenarios

Suitable for enterprises and individual developers who need an efficient search engine, especially for applications that need to quickly switch between different Meilisearch instances.

Main features

Index and document managementEasily create, delete, and update indexes and their corresponding documents.

Settings configuration and managementAdjust the global or specific index - level settings of Meilisearch, such as sorting rules, filtering conditions, etc.

Task monitoring and API key managementView the status of ongoing tasks and cancel or delete tasks; you can also generate new API keys.

Dynamic connection configurationChange the URL and API key connected to the Meilisearch instance in real - time.

Intelligent cross - index searchSupport complex queries across one or more indexes simultaneously.

Advantages and limitations

Advantages

Powerful search performance and flexibility.

Easy to integrate into existing development processes.

Provide detailed logging and health check mechanisms.

Support seamless collaboration in a multilingual environment.

Limitations

For beginners, some advanced features may be a bit complex.

Rely on a stable network connection to ensure the success rate of remote access.

Some advanced features require an additional paid subscription version to unlock.

How to use

Clone the repository and install dependencies

Clone the project repository via Git and install the required Python packages using a virtual environment.

Configure environment variables

Set the two environment variables MEILI_HTTP_ADDR and MEILI_MASTER_KEY to point to your Meilisearch instance.

Start the server

Start the MCP server using a Python script.

Usage examples

Search the movie databaseDemonstrate how to perform a search operation within a specific index.

Switch Meilisearch instancesShow how to change the connection to another Meilisearch server.

Frequently Asked Questions

How to verify that the Meilisearch MCP Server is working properly?

What if I forget the API key?

Related resources

Official documentation

Meilisearch official documentation, including detailed API references and best practices.

GitHub code repository

The open - source code repository of this project. Contributions are welcome.

YouTube tutorial video

Watch the tutorial video made by community members.

🚀 Meilisearch MCP Server

Meilisearch MCP Server is a tool based on the Model Context Protocol (MCP), designed to provide efficient and flexible search and indexing capabilities. This document details its installation, configuration, usage, and related features.

🚀 Quick Start

📦 Installation

Environment Variables

Before running the server, ensure the following environment variables are set:

MEILISERVER: Specifies the address of the Meilisearch service, defaulting to http://localhost:7200.
MCP_API_KEY: The authentication key for the MCP interface.

Dynamic Connection Configuration

It supports dynamic adjustment of connection parameters such as proxy and SSL verification. Use the following commands to view or modify the configuration:

# View the current configuration
curl http://localhost:7200/config

# Modify the configuration
curl --data '{"tls_skip_verify":true}' http://localhost:7200/config

Search Functionality

It supports multiple search modes, including exact match and fuzzy search. For example:

# Exact query
curl --user_key your_api_key --get 'http://localhost:7200/indexes/your_index_name/search?q=your_query'

# Fuzzy query
curl --user_key your_api_key --data '{"q":"search term","page":1}' http://localhost:7200/indexes/your_index_name/search

Running the Server

Start the Meilisearch MCP server:

python -m src.meilisearch_mcp

💻 Usage Examples

Integration with Claude Desktop

Add the following content to claude_desktop_config.json to integrate the MCP server:

{
  "mcp_server": {
    "url": "http://localhost:7200",
    "api_key": "your_api_key"
  }
}

Testing Tools

Use the Node.js tool to start the Inspector:

npx @modelcontextprotocol/inspector python -m src.meilisearch_mcp

✨ Features

Connection Management

get-connection-settings: Retrieve the current connection settings.
update-connection-settings: Update the connection parameters.

Index Management

create-index: Create a new index.
delete-index: Delete a specified index.
list-indexes: View all indexes.

Document Operations

add-document: Add a document.
get-document: Retrieve a single document.
update-document: Update a document.
delete-document: Delete a document.

Settings Management

get-settings: Retrieve the index settings.
update-settings: Update the index configuration.

Task Management

create-task: Create a new task.
get-task: Retrieve the task status.
list-tasks: View all tasks.
cancel-task: Cancel an unfinished task.

System Monitoring

health-check: Check the server's health status.
get-stats: Retrieve system statistics.
get-version: View the Meilisearch version.

🤝 Contribution Guidelines

Fork the project repository.
Create a feature branch.
Commit your code changes.
Send a Pull Request.

📄 License

This project is licensed under the MIT License.

Featured MCP Services

Markdownify MCP

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

554

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

745

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご