About Meilisearch Hybrid Search MCP
Meilisearch Hybrid Search MCP is an MCP server published by miiton in the Developer Tools category: a mcp server that supports hybrid search for meilisearch written in Go.
The repository has 11 stars and 1 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/miiton/meilisearch-hybrid-search-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Meilisearch Hybrid Search MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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:
go build -o meilisearch-hybrid-search-mcp .
# windows
GOOS=windows GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp.exe .
# linux
GOOS=linux GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp .
# mac
GOOS=macos GOARCH=amd64 go build -o meilisearch-hybrid-search-mcp .
Run the server:
./meilisearch-hybrid-search-mcp
The server will listen on standard input/output.
Available Tool: hybrid_search
This tool performs a hybrid search on the configured Meilisearch index.
Description: Hybrid search your documents in Meilisearch index.
Arguments:
keywords(string, required): The search query keywords.semantic_ratio(number, optional, default: 0.5): Controls the balance between keyword and semantic search.0.0: Pure keyword search.1.0: Pure semantic search.0.5: Balanced keyword and semantic search.
filterable_attribute(string, optional): The attribute name to filter results on (e.g., "genre", "author"). Requiresfilter_word.filter_word(string, optional): The value to filter the specifiedfilterable_attributeby (e.g., "Drama", "Tolkien"). Requiresfilterable_attribute.
README fetched from the repository 7 days ago. The original is authoritative.