Meilisearch Hybrid Search MCP Server

Name: Meilisearch Hybrid Search MCP Server
Author: miiton

本地服务

github.com/miiton搜索与检索1181 周前更新

代码仓库

关于 Meilisearch Hybrid Search MCP Server

用 Go 编写的 Meilisearch 混合搜索 MCP 服务，可对指定索引结合关键词与语义向量搜索，并支持属性筛选。

主要功能

01关键词与语义向量混合搜索
02调整关键词与语义搜索比例
03按可筛选属性过滤结果

适用场景

01在 Meilisearch 索引中搜索文档
02按作者或类别等属性缩小结果

MCP 相关

向 MCP 客户端提供 `hybrid_search` 工具，用于查询配置的 Meilisearch 索引。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Meilisearch 混合搜索 MCP 服务

此 MCP（模型控制协议）服务提供了一个用于在 Meilisearch 索引上执行混合搜索的工具。它可以结合基于关键词的搜索与语义向量搜索。

环境变量

运行服务前，请设置以下环境变量：

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)

构建和运行

构建服务：

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 .

运行服务：

./meilisearch-hybrid-search-mcp

服务将监听标准输入/输出。

可用工具：`hybrid_search`

此工具会在配置的 Meilisearch 索引上执行混合搜索。

描述： 在 Meilisearch 索引中混合搜索文档。

参数：

keywords（字符串，必需）：搜索查询关键词。
semantic_ratio（数字，可选，默认值：0.5）：控制关键词搜索与语义搜索之间的权重。
- 0.0：纯关键词搜索。
- 1.0：纯语义搜索。
- 0.5：平衡关键词搜索与语义搜索。
filterable_attribute（字符串，可选）：用于筛选结果的属性名称（例如，“genre”“author”）。需要设置 filter_word。
filter_word（字符串，可选）：用于筛选指定 filterable_attribute 的值（例如，“Drama”“Tolkien”）。需要设置 filterable_attribute。