mcpField
M
Meilisearch Hybrid Search MCP Server

Meilisearch Hybrid Search MCP Server

Local
github.com/miitonSearch11Updated 81w ago
Repository

About Meilisearch Hybrid Search MCP Server

A Go MCP server for hybrid search over a configured Meilisearch index. It combines keyword and semantic vector search, with optional attribute-based filtering.

Key features

  1. 01Keyword and semantic vector search
  2. 02Set the keyword-semantic balance
  3. 03Filter results by attributes

Use cases

  1. 01Search documents in a Meilisearch index
  2. 02Narrow results by author or category

MCP support

It exposes the `hybrid_search` tool to MCP clients for querying a configured Meilisearch index.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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"). Requires filter_word.
  • filter_word (string, optional): The value to filter the specified filterable_attribute by (e.g., "Drama", "Tolkien"). Requires filterable_attribute.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.