Meilisearch Hybrid Search MCP Server logo

Meilisearch Hybrid Search MCP Server

by miiton

This MCP server provides a tool for performing hybrid searches on a Meilisearch index, combining keyword-based search with semantic vector search. It allows for fine-grained control over the balance between keyword and semantic relevance.

View on GitHub

Last updated: N/A

What is Meilisearch Hybrid Search MCP Server?

This is an MCP (Model Control Protocol) server designed to enhance Meilisearch's search capabilities by enabling hybrid search. It combines traditional keyword-based search with semantic vector search to improve search relevance and accuracy.

How to use Meilisearch Hybrid Search MCP Server?

  1. Set the required environment variables (MEILI_HOST, MEILI_API_KEY, MEILI_INDEX, MEILI_EMBEDDER, MEILI_FILTERABLE_ATTRIBUTES). 2. Build the server using go build. 3. Run the server. 4. Use the hybrid_search tool via standard input/output, providing the necessary arguments (keywords, semantic_ratio, filterable_attribute, filter_word).

Key features of Meilisearch Hybrid Search MCP Server

  • Hybrid keyword and semantic search

  • Control over keyword/semantic balance (semantic_ratio)

  • Filtering based on attribute values

  • Easy integration with Meilisearch

  • MCP interface

Use cases of Meilisearch Hybrid Search MCP Server

  • Improving search relevance in e-commerce platforms

  • Enhancing document retrieval systems

  • Powering AI-driven search applications

  • Personalized search experiences based on user preferences

FAQ from Meilisearch Hybrid Search MCP Server

What is the purpose of the semantic_ratio?

The semantic_ratio controls the balance between keyword and semantic search. A value of 0.0 indicates pure keyword search, 1.0 indicates pure semantic search, and 0.5 represents a balanced approach.

What environment variables are required?

The required environment variables are MEILI_HOST, MEILI_API_KEY, MEILI_INDEX, MEILI_EMBEDDER, and MEILI_FILTERABLE_ATTRIBUTES.

How do I specify filterable attributes?

The MEILI_FILTERABLE_ATTRIBUTES environment variable should contain a comma-separated list of attribute names that are configured as filterable in your Meilisearch index settings.

What is the hybrid_search tool?

The hybrid_search tool is the primary function of this server, allowing you to perform hybrid searches on your Meilisearch index.

How do I build the server for different operating systems?

Use the go build command with the GOOS and GOARCH environment variables set accordingly (e.g., GOOS=windows GOARCH=amd64 for Windows).