Meilisearch Hybrid Search MCP Server
About
A mcp server that supports hybrid search for meilisearch written in Go
Details
- Author
- miiton
- GitHub stars
- 11
- Downloads
- 419
- Categories
- Search
Jump to
- Executes hybrid searches (keyword + semantic) on a Meilisearch index
- Adjustable balance between keyword and semantic search
- Optional filtering by a document attribute
- Configured entirely via environment variables
- Adheres to the MCP protocol for tool invocation
- Supports any embedder configured in Meilisearch
Set the required environment variables (MEILI_HOST, MEILI_API_KEY, MEILI_INDEX, MEILI_EMBEDDER, and optionally MEILI_FILTERABLE_ATTRIBUTES), build the Go project, and run the binary. The server provides one tool named hybrid_search that accepts a required keywords string and optional semantic_ratio, filterable_attribute, and filter_word arguments.
Meilisearch Hybrid Search MCP Server
This MCP (Model Control Protocol) server provides a tool for performing hybrid searches on a Meilisearch index. It allows combining keyword-based search with semantic vector search.
Environment Variables
Set the following environment variables before running the server:
export MEILI_HOST="http://your-meilisearch-instance:7700" # Meilisearch host URL
export MEILI_API_KEY="your_api_key" # Meilisearch API key (if required)
export MEILI_INDEX="your_index_name" # The name of the index to search in
export MEILI_EMBEDDER="your_embedder_name" # The name of the embedder configured in Meilisearch (e.g., 'default', 'myOpenai')
export MEILI_FILTERABLE_ATTRIBUTES="attr1,attr2" # Comma-separated filterable attributes for AI awareness (from index settings)
Building and Running
Build the server:
```bash
go build -o meilisearch-hybrid-search-mcp .
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
